home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / pine394.zip / bin / pine.hlp < prev    next >
Text File  |  1996-06-25  |  275KB  |  5,790 lines
  1. # $Id: pine.hlp,v 4.230 1996/06/11 06:40:52 gray Exp $
  2. #
  3. #           T H E   P I N E    M E S S A G E   S Y S T E M
  4. #
  5. #   Laurence Lundblade, Mike Seibel, Mark Crispin, Steve Hubert,
  6. #      Sheryl Erez, David Miller
  7. #   Networks & Distributed Computing
  8. #   Computing & Communications
  9. #   University of Washington
  10. #   Administration Building, AG-44
  11. #   Seattle, Washington, 98195, USA
  12. #
  13. #   Email: pine@cac.washington.edu
  14. #
  15. #   Pine and Pico are trademarks of the University of Washington.
  16. #   No commercial use of these trademarks may be made without prior
  17. #   written permission of the University of Washington.
  18. #
  19. #   Pine, Pico and Pilot Copyright 1989-1996  University of Washington
  20. #
  21. #   Permission to compile and execute this software and use its
  22. #   documentation for any purpose and without fee to the University of
  23. #   Washington is hereby granted, provided that the above copyright notice
  24. #   appears in all copies and that both the above copyright notice and this
  25. #   permission notice appear in supporting documentation, and that the name
  26. #   of the University of Washington not be used in advertising or publicity
  27. #   pertaining to distribution of the software without specific, written
  28. #   prior permission.  This software is made available "as is", and
  29. #   THE UNIVERSITY OF WASHINGTON DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED,
  30. #   WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED
  31. #   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND IN
  32. #   NO EVENT SHALL THE UNIVERSITY OF WASHINGTON BE LIABLE FOR ANY SPECIAL,
  33. #   INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  34. #   LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, TORT
  35. #   (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF OR IN CONNECTION
  36. #   WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  37. #
  38. #   Pine was originally based in part on The Elm Mail System:
  39. #
  40. #    ***********************************************************************
  41. #    *       The Elm Mail System  -  Revision: 2.13                        *
  42. #    *                                                                     *
  43. #    *       Copyright (c) 1986, 1987 Dave Taylor                          *
  44. #    *       Copyright (c) 1988, 1989 USENET Community Trust               *
  45. #    ***********************************************************************
  46. #
  47. #
  48.          Help text for the Pine mailer
  49. This file is in a format created to be turned into text strings in a C
  50. program and to support a few other features such as page numbering and
  51. alternate versions that are created at run time.  There are two shell
  52. scripts that run on this.  Cmplhelp.sh is the first and turns this into a
  53. C file (helptext.c) of text strings that are compiled and linked. The
  54. other program, cmplhlp2.sh, turns this into a .h file (helptext.h) with
  55. extern string definitions of the strings in the .c file.  The code that
  56. actually processes these files while pine is running is in help.c
  57.  
  58. The lines with "===== xxxx ====" divide the different help screens.  The
  59. xxx is the name of the variable that strings will be put in, which are
  60. also declared in helptext.h.
  61.  
  62. # is a comment
  63.  
  64. {x:y} constructs are the key bindings, either x or y is used.
  65.       x and y are best the same length so things always line up
  66.  
  67. __   doesn't do anything but help keep things lined up in this file.  It is
  68.      removed before printing to the screen (except for ^_).
  69.  
  70. To actually get a { in the text use '{{:{}'.  To get a } make sure it is not
  71. matched by a {
  72.  
  73. The text is formatted in emacs with the fill column set to 78.
  74.  
  75. Text with ______ indents is formatted with fill column at 82
  76. ___include <filename> includes a file at run time.  It should be
  77. followed by "___end_include" with text to be displayed if the file
  78. is unopenable in between.
  79. Any occurance of ___version will be replaced with the current version
  80. number as defined in "pine.h"
  81. Any occurance of ___cdate will be replace with the date and time the currently
  82. running binary was compiled.
  83. Any occurance of ___tdate will be replaced with the current day's date
  84. and time.
  85.  
  86. NOTE: Several sections of help text which weren't being used were removed
  87. at RCS version number 4.122.  In particular, there were some placeholders
  88. with help text for the config screen and the composer that didn't have any
  89. reasonable place to be called from.
  90.  
  91. ============= h_news =================
  92.      RELEASE NOTES for PINE -- A Program for Internet News and Email
  93.                 Version ___version (built ___cdate)
  94.                          University of Washington
  95.  
  96.  
  97. TABLE OF CONTENTS
  98.         (1) Summary of Recent Changes
  99.         (2) PC-Pine Notes
  100.         (3) Configuration
  101.         (4) Coming Attractions
  102.         (5) History
  103.         (6) Credits
  104.         (7) Legal Notices
  105.  
  106. ---------------------------------
  107. | (1) Summary of Recent Changes |
  108. ---------------------------------
  109.  
  110.  
  111. NEW IN 3.94
  112.  
  113.  o Many bug fixes
  114.  
  115.  o New features:
  116.  
  117.    enable-goto-in-file-browser
  118.    print-includes-from-line
  119.    enable-background-sending     (EXPERIMENTAL!!!!)
  120.    disable-busy-alarm            (hidden feature for debugging)
  121.    disable-default-in-bug-report (hidden feature for sysadmins)
  122.    save-aggregates-imap-copy     (hidden feature for future use)
  123.  
  124.  o New options for saved-msg-name-rule
  125.  o Setting empty-header-message=\"\" suppresses Undisclosed Recipients:;
  126.  o X-Sender header changed to X-X-Sender
  127.  o Printing \"Folder Index\" now includes folder name
  128.  o ESC ESC SPACE now works as alternate for Control-SPACE (Mark cmd)
  129.  
  130. >>> NOTE: Please read the section on SENDING STRATEGY later in the
  131.     Release Notes.  In particular, note that the EXPERIMENTAL feature
  132.     to allow selective \"background\" sending is not available on all
  133.     flavors of Unix, and that it should not be used if you are nearly
  134.     out of disk space.
  135.  
  136.  
  137. NEW IN 3.93
  138.  
  139.  o Mostly bug fixes (more than 100 since 3.92)
  140.  o scroll-margin variable to control paging behavior
  141.  o empty-header-message variable to override \"Undisclosed recipients\"
  142.  o expanded-view-of-distribution-lists feature
  143.  o Help text additions/corrections
  144.  
  145.  
  146. TOP TEN NEW FEATURES IN 3.92
  147.  
  148.  o Optional message filtering hooks (can be used for PGP integration)
  149.  o Extensive address and list management improvements
  150.  o Additional printing capabilities
  151.  o Improved MIME and non-ascii support (mime.types, 1522, 8BITMIME)
  152.  o Improved PC-Pine for Windows (GUI amenities, 32bit version)
  153.  o Some modest performance improvements
  154.  o Lots of new personal-preference options and command improvements
  155.  o Hooks for integral file transfer between desktop computer & Unix Pine
  156.  o Builtin signature editor
  157.  o Improved user feedback when Pine is busy or waiting
  158.  
  159. This release also includes a stand-alone version of Pine's internal
  160. file browser, named \"pilot\" --for \"Pine's Lister Of Things\", and an
  161. OS/2 version of Pine contributed by David Nugent.
  162.  
  163. ---------------------------------
  164.  
  165. Here is a more extensive (but by no means exhaustive) list of changes...
  166.  
  167. MISC
  168.  o Visual BUSY (or % completion) indication during long operations
  169.  o Delete flag no longer preserved on Save
  170.  o Alerts require confirmation
  171.  o Timeouts on open and read operations
  172.  o Hooks for external filtering of incoming and outgoing messages
  173.  o Turn off tty messages by default to reduce confusion
  174.  o Unix and PC-Pine now use same search path for certain support files
  175.  o Access to mailboxes in accounts with a different login name {host/user= }
  176.  o Can re-open INBOX without restarting Pine
  177.  o New-mail check interval may be set
  178.  o Can specify your alternate (alias) addresses
  179.  o RFC-1522 support for non-ASCII character sets in headers
  180.  o X/Motif users: Mouse support
  181.  o X/Motif users: Pine changes icon label when new mail arrives
  182.  o Setup includes integral signature editor command
  183.  o Improved IMAP \"dead stream\" handling
  184.  o Improvements for restricted-access environments (operating-dir variable)
  185.  
  186. ADDRESS MANAGEMENT IMPROVEMENTS
  187.  o Improved Take interface and capabilities
  188.     - Take addresses in message body
  189.     - Take between address books
  190.     - WhereIs subcommand on Take screen
  191.  o Improved Addressbook capabilities
  192.     - View/Edit screen
  193.     - Simplification of regular vs. list entries
  194.     - Easier to add entries to lists
  195.     - Export subcommand
  196.     - Global config var to set default addressbook entries
  197.     - Select multiple addresses for composer without re-entering
  198.     - Can forward addrbook entries using MIME type Application/Directory
  199.  
  200. NEWS IMPROVEMENTS
  201.  o Subscribe to multiple groups without re-entering for each
  202.  o Support for follow-ups header in Reply and View
  203.  o Support NNTP servers requiring authentication
  204.  o Compile-time option to submit news locally (rather than via NNTP)
  205.  o Improved Reply handling
  206.  
  207. PRINTING IMPROVEMENTS
  208.  o New printer configuration screen
  209.  o Control of trailing form-feed
  210.  o Allow definition of list of printers
  211.  o New features to control separators between messages
  212.  o New feature to allow per-message access to custom print command
  213.  o Ability to print message index
  214.  o Forced enabling of xon-xoff flow-control during printing
  215.  o Ability to set init or trailer strings for each printer definition
  216.  
  217. VIEW MESSAGE IMPROVEMENTS
  218.  o Number of lines of text overlap between pages can be set
  219.  o Control of which headers are displayed by default
  220.  
  221. COMPOSER IMPROVEMENTS
  222.  o LCC (List CC) header for hiding long address lists
  223.  o To: will get dummy group header if only BCC given (no TO or CC).
  224.  o Support for verbose sending (shows result of attempt to send)
  225.  o Improved justification algorithm
  226.  o Partial support for justifying included message text
  227.  o Can delete messages from Postponed Msg index
  228.  o ^R sub-option to include/attach a message # from current folder
  229.  o ^R sub-option to upload files from desktop computer directly into composer
  230.  o Word wrap preserves NLs
  231.  o File name completion (^R, ^J and \"Attchmnt:\"?)
  232.  o If message canceled, save (optionally) in .dead.letter
  233.     Note: this is a safety net in case msg is canceled by accident;
  234.           the safety net can be disabled via quell-dead-letter-on-cancel
  235.  o Composer checkpointing (Look for files beginning with: #pico... )
  236.  o Config variable to specify alternate speller
  237.  o Included text indent string may be reset
  238.  o Can set composer wrap column
  239.  o Can modify ^K behavior to cut from cursor position, ala emacs
  240.  o Can select whether DELETE key acts like ^D or ^H
  241.  o Use separate buffers for cut and justify
  242.  o Way to input 8-bit characters: <ESC><ESC><dec-num><dec-num><dec-num>
  243.  o Resuming postponed composition: show fcc and bcc if not default values
  244.  
  245. MISC COMMAND IMPROVEMENTS
  246.  o Pipe
  247.     -subcommand to select raw message output mode
  248.     -subcommand to select free-output mode
  249.     -subcommand to select whether mailbox message delimiter is included
  250.  o Sort by TO: or CC: field
  251.  o Bounce
  252.     -Apply now supports Bounce
  253.     -^T subcmd to get to address book
  254.  o Select
  255.     -Allows inversion of current selection
  256.      -Improved user-interface for \"By Date\" selection
  257.  o Reply
  258.     -Newsgroups header generally ignored unless Path header present
  259.     -New option to allow simultaneous email reply and news followup
  260.     -Reply-to-all improved for LISTSERV case
  261.     -Feature to use Reply-to address without prompting
  262.  o Setup/Config screen
  263.     -Allow exit without committing changes
  264.     -Improved Add vs. Change behavior
  265.  o Improved Bug Report command
  266.  o Main menu now has Journal subcommand (log of informational messages)
  267.  o New \"Select current msg and advance\" command in Index and ViewMsg (\":\")
  268.  o Export includes ability to download message to desktop computer
  269.  o Flag command revised to provide (optional) display of all flags
  270.  
  271. FEATURES TO ASSIST VISUALLY IMPAIRED USERS
  272.  o show-cursor feature
  273.  o single-column folder/file list display
  274.  o disable-keymenu feature
  275.  o control of index display format
  276.  o control of addressbook display format
  277.  o control of page overlap in View Message
  278.  
  279. FOLDER AND FILE MANAGEMENT IMPROVEMENTS
  280.  o New default save and fcc name rules
  281.  o Control over whether dot files are displayed
  282.  o Incoming-archive-folders list
  283.  o Pruned-folders list
  284.  
  285. MIME IMPROVEMENTS
  286.  o mime.types file to control content-type of attachment
  287.  o Option to enable 8BITMIME negotiation when ESMTP server available
  288.  o Option to suppress MIME encoding for News posting
  289.  o View Message and View Attach show type/subtype
  290.  o New \"About Attachment\" subcommand under View Attach
  291.  o RFC-1522 non-ascii character support for headers
  292.  o Mailcap can override internal viewer for text/types except text/plain
  293.  o Suppress display of text types overridden in mailcap, except text/plain
  294.  o Composer shows assigned content-type for attachments
  295.  o Can set mime-types and mailcap file path
  296.  o Try to display first text type in message even if mis-labeled
  297.  
  298. NEW COMMAND LINE OPTIONS
  299.  o A -c context flag for -f (allows opening path w/o context interpretation)
  300.  o Allow \"pine fred < file \"  (which still puts you into the composer)
  301.  o For Pico: operating-directory flag, similar to Pine's config variable
  302.  
  303. PERFORMANCE IMPROVEMENTS
  304.  o Internal optimizations
  305.  o Improved use of IMAP streams when changing folders
  306.  o Use of same stream for aggregate saves
  307.  o Major improvements in informational message display and queuing
  308.  o Full caching enabled in Win32 version of PC-Pine
  309.  
  310. NEW VARIABLES
  311.  
  312.  o incoming-archive-folders=
  313.  o pruned-folders=
  314.  o default-saved-msg-folder=
  315.  o viewer-hdrs=
  316.  o goto-default-rule=
  317.  o speller=
  318.  o composer-wrap-column=
  319.  o reply-indent-string=
  320.  o display-filters=
  321.  o sending-filters=
  322.  o alt-addresses=
  323.  o addressbook-formats=
  324.  o index-format=
  325.  o viewer-overlap=
  326.  o status-message-delay=
  327.  o mail-check-interval=
  328.  o newsrc-path=
  329.  o news-active-file-path=
  330.  o news-spool-directory=
  331.  o upload-command=
  332.  o upload-command-prefix=
  333.  o download-command=
  334.  o download-command-prefix=
  335.  o mailcap-search-path=
  336.  o mimetype-search-path=
  337.  o sendmail-path=           (intentionally omitted from config screen)
  338.  o operating-dir=           (intentionally omitted from config screen)
  339.  
  340. Variables that can only be set in pine.conf or pine.conf.fixed:
  341.  
  342.  o bugs-additional-data=
  343.  o suggest-fullname=
  344.  o suggest-address=
  345.  o local-fullname=
  346.  o local-address=
  347.  o forced-abook-entry=
  348.  o kblock-passwd-count=
  349.  
  350.  NEW FEATURES:
  351.  
  352.  o allow-talk                (enables other processes to write to tty)
  353.  o auto-zoom-after-select
  354.  o auto-unzoom-after-apply
  355.  o compose-cut-from-cursor   (ala emacs)
  356.  o compose-maps-delete-key-to-ctrl-d
  357.  o compose-send-offers-first-filter
  358.  o disable-keymenu
  359.  o disable-signature-edit-cmd
  360.  o enable-8bit-esmtp-negotiation
  361.  o enable-8bit-nntp-posting
  362.  o enable-cruise-mode        (SPACE acts like tab when at end of msg)
  363.  o enable-cruise-mode-delete (look at it once, then it disappears)
  364.  o enable-dot-files          (file browser normally hides dot files)
  365.  o enable-dot-folders        (folder lister normally hides them)
  366.  o enable-flag-screen-implicitly
  367.  o enable-mouse-in-xterm
  368.  o enable-verbose-smtp-posting
  369.  o fcc-on-bounce
  370.  o pass-control-characters-as-is
  371.  o print-offers-custom-cmd-prompt
  372.  o print-index-enabled
  373.  o print-formfeed-between-messages
  374.  o quell-dead-letter-on-cancel
  375.  o quell-lock-failure-warnings
  376.  o quell-status-message-beeping
  377.  o reply-always-uses-reply-to
  378.  o save-will-quote-leading-froms
  379.  o show-cursor
  380.  o single-column-folder-list
  381.  o tab-visits-next-new-message-only  (skips those marked Important)
  382.  o use-sender-not-x-sender
  383.  
  384. Modified:  preserve-start-stop-characters  (now implicit during printing)
  385.  
  386. NEW FEATURES SPECIFIC TO PC-PINE for Windows
  387.  
  388.  o Pull-down menus
  389.  o Optional tool bar
  390.  o Scroll bars
  391.  o Additional mouse support
  392.  o Improved cut/paste support
  393.  o Ability to display message in separate window
  394.  o Screen and printer fonts separately controllable
  395.  o Improved Windows printing support
  396.  o Spell checker interface
  397.  o Piping support
  398.  o Drag'n'drop into composer
  399.  o Create pinecrsh.txt when it crashes
  400.  o Win32 version, with full caching
  401.  o Control-6 works consistently as ^^ (Mark)
  402.  o Can enable dialogue boxes in lieu of normal prompts
  403.  
  404. BUG FIXES
  405.  
  406.  o  pine.conf (init.c) fix (some variables being ignored)
  407.  o  Export bug (invalid message separator syntax)
  408.  o  Empty .pine-interrupted not removed
  409.  o  Interrupted compositions not being saved
  410.  o  Looping fixes
  411.  o  PLUS hundreds of others...
  412.  
  413. OTHER
  414.  
  415.  o Pine file browser available as a stand-alone program (Pilot)
  416.  o New version of Pico
  417.  o Revised Update service, accessed by Pine's Setup/Update command
  418.  
  419. SENDING STRATEGY
  420.  
  421. Beginning with 3.92, Pine sends messages in a different way.
  422. Previously, Pine created a temp file containing the message to be
  423. sent, and invoked sendmail in a way that would cause it to derive
  424. the SMTP envelope information from the message headers.  This had
  425. several disadvantages, including the inability to support ESMTP
  426. options such as 8BITMIME.  So now Pine, by default, invokes sendmail
  427. such that it can directly interact via SMTP commands.  However,
  428. the direct interaction has caused undesirable side effects at some
  429. sites.  For example:
  430.    
  431.  o If your sendmail is configured to do address validation, it may
  432.    take significantly longer for sendmail to accept the message
  433.    than it used to.  The user sees this delay in Pine.
  434.  
  435.  o Some sendmails are configured to generate X-Authentication-Warning (see
  436.    below for more information on this warning) headers when directly
  437.    invoked by Pine. 
  438.  
  439. If you experience sending difficulties, the first thing to try is
  440. setting the following configuration variable:  smtp-server=localhost
  441.  
  442. If that doesn't help, it's possible to revert to Pine's previous method
  443. of sending via a temporary file.  In the contrib/utils directory of the
  444. distribution, there is a shell script named \"sendit.sh\"
  445.  
  446. To revert to the previous sending-method, install this script and set the
  447. sendmail-path variable to its path. 
  448.  
  449. X-AUTHENTICATION-WARNING
  450.  
  451. Recent versions of Pine use a default sending method that causes the
  452. header:
  453.  
  454.   X-Authentication-Warning: <hostname>: <user> owned process doing -bs 
  455.  
  456. to be added to outgoing mail in some cases.  This header is added by
  457. sendmail version 8 when the sendmail configuration option:
  458.  
  459.   PrivacyOptions=authwarnings
  460.  
  461. is set.  There are a couple ways to fix this.
  462.  
  463. 1. Don't set the authwarnings option in sendmail.cf.  
  464. 2. In the Pine configuration, set smtp-server to some value.  This could
  465.    be done globally for everyone in /usr/local/lib/pine.conf or by
  466.    individuals in their own configurations. 
  467.  
  468. The smtp-server variable may be set to the name of any host which is
  469. running an SMTP server.  Often, the host you are running Pine on will also
  470. be running a sendmail daemon.  In that case, it is usually enough to set: 
  471.  
  472.    smtp-server=localhost
  473.  
  474. This works because \"localhost\" is usually a pseudo-hostname for the
  475. loopback interface on a Unix host.  If \"localhost\" doesn't work, you can
  476. try the actual name of the host you are running Pine on, or the name of
  477. some other host which is running an SMTP server.  For example:
  478.  
  479.    smtp-server=somehost.company.com
  480.  
  481. BACKGROUND POSTING                                       (EXPERIMENTAL!!!)
  482.  
  483. New in Pine 3.94 is an EXPERIMENTAL feature permitting optional sending
  484. of messages \"in the background\".  Choosing this option at the \"Send?\"
  485. confirmation prompt causes Pine to split into two processes; one returns
  486. immediately to your control while the other continues sending the
  487. message.
  488.  
  489. It does not alter the method Pine uses to send messages (via SMTP,
  490. typically), but it does affect the way in which errors are reported.
  491. Normal, interactive sending requires you to wait until the receiving
  492. transport agent has accepted the message.  Usually, errors are reported
  493. immediately, and Pine returns you to the composer with the error message
  494. displayed.  With \"background\" sending chosen, Pine can't return to the
  495. message editor.  Pine will display an error message, but you need to
  496. resume posting manually by typing \"C\" and answering \"Y\"es to the
  497. \"Continue INTERRUPTED message?\" prompt.
  498.  
  499. NOTE: As this feature requires specific support (i.e., the waitpid system
  500.       call) from the operating system, it is not available on all flavors
  501.       of Unix.  Therefore, you may not find it in your \"Setup Config\"
  502.       screen.  See the feature's help text in the Config screen for more
  503.       caveats.
  504.  
  505. STABILITY AND LIFE EXPECTANCY
  506.  
  507. Pine 3.94 corrects many of the bugs we failed to resolve (or introduced) 
  508. in version 3.93, which was primarily a bug-fix release for 3.92, our last
  509. major release.
  510.  
  511. We are anxious to now focus our attention on Pine 4.00, which will mostly
  512. have the same functionality as 3.94, but will use the new IMAP4-capable
  513. c-client libraries in preparation for utilizing certain IMAP4 extensions
  514. later on.  No doubt it will also contain more bug fixes, and perhaps a few
  515. new features. 
  516.  
  517. ---------------------
  518. | (2) PC-PINE NOTES |
  519. ---------------------
  520.  
  521. PC-Pine is now available for Windows/Winsock in both 16 and 32 bit
  522. versions, as well as the following DOS versions: packet driver, Novell
  523. LWP, FTP PC-TCP, Sun PC-NFS.  Only the 32 bit Windows version has full
  524. caching enabled; thus it should be noticeably faster than the DOS and
  525. 16 bit Windows versions.  Sorting, however, is still slow.
  526.  
  527. Some specific limitations of the DOS version (these do not apply to
  528. the Windows/Winsock version of PC-Pine):
  529.    o The unix-pipe-cmd function is not available.
  530.    o There is no spelling checker.
  531.    o Alternate editor function is not available.
  532.    o Memory: the DOS version needs about 500K out of 640K.
  533.    o The DOS version can't run image viewer from within Pine, due to memory.
  534.    o Messages (excluding attachments) must fit in DOS memory,
  535.      however, attachments may be any size.
  536.  
  537. Additional notes:
  538.  
  539. -The Windows/Winsock version of PC-Pine is not a full GUI Windows
  540.  application, however, version 3.92 introduces quite a few GUI
  541.  amenities, including: scroll bars, pull-down menus, expanded mouse
  542.  support, etc.
  543.  
  544. -While message folders may be either local or remote, several support
  545.  files must be available on the local disk.  In particular your
  546.  PINERC config file, ADDRBOOK, NEWSRC, and PINE.SIG (your signature file).
  547.  Other files (postponed and interrupted messages, debug files) are also
  548.  stored locally.  Some users of both PC-Pine and Unix Pine must worry
  549.  about keeping their pinerc, address book, and newsrc files in sync.
  550.  This may be done using remote file system protocols or manual copying.
  551.  Remote access to these support files is *definitely* planned for the future.
  552.  
  553. -The PC-PINE message folder format is based on byte-counts for maximum
  554.  efficiency, so they must not be edited. The format is non-standard, but
  555.  conversion utilities would not be difficult. This format is supported in
  556.  Unix Pine as well.  PC-Pine can also open Unix-style folders for
  557.  READ-ONLY access.
  558.  
  559. -Don't expect to display a picture without exiting PC-Pine for DOS, due
  560.  to DOS memory limitations.  In some configurations, there *may* be enough
  561.  memory for the viewer and a small image, but don't count on it.  With
  562.  PC-Pine for Windows/Winsock, the memory constraints are greatly
  563.  diminished, and viewing image attachments seems to work quite well.  We
  564.  have been testing with the \"lview\" package by Leonardo Loureiro, which
  565.  can be obtained from oak.oakland.edu or any other SimTel mirror site.
  566.  
  567. ---------------------
  568. | (3) Configuration |
  569. ---------------------
  570.  
  571. Configuration precedence.
  572.  
  573. There are several levels of Pine configuration.  Configuration values at
  574. a given level override corresponding values at lower levels.  In order of
  575. increasing precedence:
  576.  
  577.  o built-in defaults,
  578.  o system-wide pine.conf file,
  579.  o personal .pinerc file (may be set via built-in Setup/Config menu.),
  580.  o command-line options,
  581.  o system-wide pine.conf.fixed file.
  582.  
  583. There is one exception to the rule that configuration values are replaced
  584. by the value of the same option in a higher-precedence file:
  585. the feature-list variable has values that are additive, but can be
  586. negated by prepending \"no-\" in front of an individual feature name.
  587.  
  588. File name defaults.
  589.  
  590. Notes:
  591.  
  592.  o <exe dir> = directory where pine.exe found.
  593.  o <pinerc dir> = directory where pinerc found.
  594.  o * = default file name is overridable in pinerc.
  595.  o $HOME, if not explicitly set, defaults to root of the current drive.
  596.  o $MAILCAPS, if set, is used in lieu of the default mailcap search paths.
  597.  o + between the mailcap paths implies that the two files are combined.
  598.  o ; between other default paths implies that the first one found is used.
  599.  
  600. Pine looks for most support files in the same directory it finds its
  601. personal configuration file (pinerc).  The -p command-line flag may be
  602. used to specify a particular path name for the pinerc file.  If a
  603. pinerc file does not exist, it will be created (if directory permissions
  604. allow).  In PC-Pine, if -p or $PINERC are not defined, Pine will look
  605. in $HOME\\PINE and the directory containing the PINE.EXE.  If a PINERC
  606. file does not exist in either one, it will create one in the first of those
  607. two directories that is writable.  In detail:
  608.  
  609. PC-Pine:
  610.  
  611.  executable     <DOS search path>\\pine.exe
  612.  help index     <exe dir>\\pine.ndx
  613.  help text      <exe dir>\\pine.hlp
  614.  
  615.  pers config    $PINERC  ;  $HOME\\pine\\pinerc  ;  <exe dir>\\pinerc
  616.  global cfg     $PINECONF
  617.  
  618.  password       <pinerc dir>\\pine.pwd
  619.  debug          <pinerc dir>\\pinedebg.txt
  620.  crash          <pinerc dir>\\pinecrsh.txt
  621.  signature*     <pinerc dir>\\pine.sig
  622.  addressbook*   <pinerc dir>\\addrbook
  623.  addrbook lu    <pinerc dir>\\addrbook.lu    (appends .lu to addrbk name.)
  624.  mailcap*       <pinerc dir>\\mailcap  +  <exe dir>\\mailcap
  625.  mimetypes*     <pinerc dir>\\mimetype +  <exe dir>\\mimetype
  626.  newsrc*        $HOME\newsrc (if exists, else) <pinerc dir>\newsrc
  627.  sentmail*      $HOME\\mail\\sentmail.mtx
  628.  postponed*     $HOME\\mail\\postpond.mtx
  629.  interrupted    $HOME\\mail\\intruptd
  630.  
  631. Unix Pine:
  632.  
  633.  executable     <Unix search path>/pine
  634.  persnl cfg     ~/.pinerc
  635.  global cfg     /usr/local/lib/pine.conf
  636.  fixed cfg      /usr/local/lib/pine.conf.fixed
  637.  local help     /usr/local/lib/pine.info
  638.  
  639.  interrupted    ~/.pine-interrupted-mail
  640.  debug          ~/.pine-debugN
  641.  crash        ~/.pine-crash
  642.  newsrc*        ~/.newsrc
  643.  signature*     <pinerc dir>/.signature
  644.  addressbook*   <pinerc dir>/.addressbook
  645.  addrbook lu    <pinerc dir>/.addressbook.lu  (appends .lu to addrbk name.)
  646.  postponed*     ~/mail/postponed-msgs
  647.  sentmail*      ~/mail/sent-mail
  648.  mailcap*       ~/.mailcap + /etc/mailcap
  649.                            + /usr/etc/mailcap + /usr/local/etc/mailcap
  650.  mimetypes*     ~/.mime.types + /etc/mime.types + /usr/local/lib/mime.types
  651.  
  652.  news-spool    varies across Unix flavors, e.g. /usr/spool/news or /var/news
  653.  active-news    varies across Unix flavors, e.g. /usr/lib/news/active
  654.  lock files     /tmp/.\\usr\\spool\\mail\\xxxx
  655.  inbox          /usr/spool/mail/xxxx
  656.  password       /etc/passwd
  657.  
  658. Mailcap files.
  659.  
  660. Pine honors the mailcap configuration system for specifying external
  661. programs for handling attachments.  The mailcap file maps MIME attachment
  662. types to the external programs loaded on your system which can display
  663. and/or print the file.  A sample mailcap file comes bundled with the Pine
  664. distribution.  It includes comments which explain the syntax you need to
  665. use for mailcap.  With the mailcap file, any program (mail readers,
  666. newsreaders, WWW clients) can use the same configuration for handling
  667. MIME-encoded data.
  668.  
  669. MIME-Types files.
  670.  
  671. Pine uses mime-types files (.mime.types or MIMETYPE) to determine
  672. what Content-Type to use for labeling an attached file, based on
  673. the file extension.  That is, this file provides a mapping between
  674. filename extensions and MIME content-types.
  675.  
  676. Environment variables.
  677.  
  678. PC-Pine uses the following environment variables:
  679.  
  680.   PINERC      (Optional path to pinerc file.)
  681.   PINECONF    (Optional path to global pine config file.)
  682.   HOME
  683.   TMP or TEMP
  684.   COMSPEC
  685.   MAILCAPS    (A *semicolon* delimited list of path names to mailcap files.)
  686.  
  687. Unix Pine uses the following environment variables:
  688.  
  689.   TERM        (Tells Pine what kind of terminal is being used.)
  690.   DISPLAY     (Determines if Pine will try to display IMAGE attachments.)
  691.   SHELL       (If not set, default is /bin/sh )
  692.   MAILCAPS    (A *colon* delimited list of path names to mailcap files)
  693.  
  694. --------------------------
  695. | (4) Coming Attractions |
  696. --------------------------
  697.  
  698. STILL NOT DONE, BUT WE WANT THEM AS MUCH AS YOU DO...
  699.  
  700.  o Hierarchy support
  701.  o Location independence of support files
  702.  o Kerberos support
  703.  o Offline and disconnected support
  704.  o External directory services access
  705.  
  706. ---------------
  707. | (5) HISTORY |
  708. ---------------
  709.  
  710. Pine was originally conceived in 1989 as a simple, easy-to-use mailer for
  711. administrative staff at the University of Washington in Seattle.  This
  712. constituency had previously been using a very nice mail system derived
  713. from UCLA's \"Ben\" mailer for the MVS operating system, but when the cost
  714. of maintaining our MVS system became prohibitive, we needed to find a
  715. Unix-based mailer that preserved the user-interface strengths of \"Ben\".
  716. Our goal was to provide a mailer that naive users could use without fear
  717. of making mistakes.  We wanted to cater to users who were less interested
  718. in learning the mechanics of using electronic mail than in doing their
  719. jobs; users who perhaps had some computer anxiety.  We felt the way to do
  720. this was to have a system that didn't do surprising things and provided
  721. immediate feedback on each operation; a mailer that had a limited set of
  722. carefully-selected functions.
  723.  
  724. At that time, we could not find any Unix mailer (commercial or freely
  725. available) that met our requirements.  Consequently, we reluctantly
  726. concluded that we would need to develop our own.  The Elm mailer seemed
  727. like a reasonable starting point since its source code was freely
  728. available, so we started modifying it.  Today there is virtually no Elm
  729. code left, and Pine has evolved so that many \"power-user\" features may
  730. be (optionally) enabled.  We have tried to remain true to our original
  731. simplicity and ease-of-use goals by providing *optional* features for
  732. sophisticated users.  In fact, if none of Pine's options are enabled, the
  733. latest version has almost the same look-and-feel as the very first
  734. version.
  735.  
  736. One of the greatest problems with most mailers on Unix systems is the
  737. editor.  One can normally choose between emacs and vi.  We experimented
  738. with some versions of emacs and settled on a hacked version of micro
  739. emacs. Eventually it became heavily modified and tightly integrated with
  740. the rest of Pine.  One of the main features of having a tightly coupled
  741. editor is that it can guide the user through editing the header of the
  742. message, and Pine takes great care to do this.  A very simple and
  743. efficient interface to the Unix spell command was also added.  The emacs-
  744. style key bindings were retained, though most of the other wild and
  745. wonderful emacs functions were not.  The Pine composition editor is also
  746. available as a very simple stand alone editor named \"pico\".
  747.  
  748. Also working at the University of Washington is the original author of the
  749. Internet Message Access Protocol (IMAP).  IMAP is a functional superset of
  750. POP, and provides a way to manipulate mailboxes on remote servers as if
  751. they were local.  Specific advantages of IMAP over POP include: support
  752. for inbox access from multiple computers, access to more than one remote
  753. folder, selective access to MIME message parts, and support for
  754. disconnected operation.
  755.  
  756. Not long after the Pine project began, The IMAP author had finished
  757. writing the \"c-client\" library as an interface to IMAP and as a switch
  758. between drivers for IMAP mailboxes, Berkeley mail files and Tenex mail
  759. files.  In time, \"c-client\" became a full messaging API with support for
  760. RFC-822 parsing, MIME parsing and decoding, SMTP and NNTP drivers, and so
  761. forth.  Great care was taken to make the code writing the mail files
  762. robust against disks filling up, and inter-process locking in order to
  763. guarantee mail file consistency.  It was clear that Pine would benefit
  764. greatly from using the c-client to access mail storage so the original
  765. low-level Elm code was replaced by calls to c-client library routines.
  766. Consequently Pine can write and access a variety of different mail file
  767. formats and new ones can be added by creating a simple driver.  In
  768. addition the c-client does a very careful job of doing all the RFC-822
  769. header parsing and achieves the highest compliance with the RFC.
  770.  
  771. Most of the work done on Pine from 6/92 to 6/93 focused on changes needed
  772. to support a truly distributed electronic messaging environment (e.g.
  773. remote folder manipulation), and getting Pine to run on DOS (which was a
  774. *lot* of work).  The first version of PC-Pine (3.84) was released in July
  775. 1993, and included first steps toward integrating news and email access in
  776. Pine. Doing the DOS port was very difficult for a variety of reasons, but
  777. especially because of DOS memory management (or lack thereof).  However,
  778. simply porting Pine 3.07 to DOS was not sufficient.  For a desktop mailer
  779. such as PC-Pine to be useful at UW, it was necessary to fully support
  780. access to existing *remote* saved-message folders, as well as local
  781. (desktop) folders -- and of course, the remote INBOX.  Accomplishing this
  782. required extensions to IMAP, a new version of the IMAPd server code, and
  783. extensive work in Pine to support multiple collections of folders.
  784.  
  785. The principal reason for porting Unix Pine to DOS/Windows was to obviate
  786. the need for PC users to transfer files between their PC and the Unix
  787. system running Pine.  Now it is possible to save messages directly to the
  788. PC's filesystem, and to directly include PC files in outgoing messages.
  789. And with Pine's MIME capability, binary files (e.g. word processing
  790. documents, spreadsheets, image files, executables) may be directly
  791. attached to your messages.
  792.  
  793. With both Pine 3.90 and 3.92, significant new functionality has been added,
  794. as can be seen by the growing number of features that can be set via
  795. Setup/Config screen.  Next will come integration of the IMAP4-capable
  796. c-client libraries, forming the basis of Pine 4.00.
  797.  
  798. ---------------
  799. | (6) CREDITS |
  800. ---------------
  801.  
  802. The University of Washington Pine development team (part of the UW Office
  803. of Computing & Communications) includes:
  804.  
  805.  Project Leader:           Mike Seibel.
  806.  Principal authors:        Mike Seibel, Steve Hubert, Laurence Lundblade*.
  807.  C-Client library & IMAPd: Mark Crispin.
  808.  Pico, the PIne COmposer:  Mike Seibel.
  809.  Bug triage, user support: David Miller.
  810.  Pine Web Pages:           Stefan Kramer, David Miller.
  811.  Documentation:            Many people!
  812.  PC-Pine for DOS:          Mike Seibel.
  813.  PC-Pine for Windows:      Tom Unger.
  814.  Project oversight:        Terry Gray.
  815.  Principal Patrons:        Ron Johnson, Mike Bryant.
  816.  Additional support:       NorthWestNet.
  817.  Initial Pine code base:   Elm, by Dave Taylor & USENET Community Trust.
  818.  Initial Pico code base:   MicroEmacs 3.6, by Dave G. Conroy.
  819.  User Interface design:    Inspired by UCLA's \"Ben\" mailer for MVS.
  820.  
  821.    * Emeritus  (Laurence is now at Qualcomm)
  822.  
  823. We'd also like to acknowledge the following contributions and contributors:
  824.  Pine for VMS:  Portia Shao and Yehavi Bourvine
  825.  Pine for OS/2: David Nugent
  826.  Special mention:   David Wall
  827.  Bug reports, bug fixes, ports, suggestions & encouragement:
  828.  
  829. The world-wide Pine community, including...
  830.  
  831.   Shoa Aminpour       Gordon Good        Richard Murphy
  832.   J.J. Baily          Bob Gregory        Il Oh
  833.   Billy Barron        Ed Greshko         Mike Ramey
  834.   Chris Beecher       Dmitri L. Gringauz Phil Rand
  835.   John Benjamins      David Halliwell    Jochiam Richter
  836.   Birko Bergt         Peter Hausken      Thomas Riemer
  837.   Ken Bobey           Jeff Hayward       Alexis Rosen
  838.   Andy Brager         Ron Johnson        Michael Ross
  839.   D.K. Brownlee       William Kreuter    Bob Sandstrom
  840.   Brian Burriston     Pekka Kytolaakso   Michael F. Santangelo
  841.   Bill Campbell       Barry Landy        Shin-ya Satoh
  842.   Russel Campbell     Chris Latham       Corey Satten
  843.   Donn Cave           Jon Lebo           Michael Shepard
  844.   Richard Cheever     Allen Leonard      Alan Thew
  845.   Mike Coghlan        Robert L. Lewis    Jason R. Thorpe
  846.   Justine Comer       Bruce Lilly        Marc Unangst
  847.   Chuck Cooper        Matthew Lyle       Edward Vielmetti
  848.   Barry Cornelius     John Mackin        Ross Wakelin
  849.   Tony Flemming       James Matheson     Rich Wales
  850.   Matthew Freedman    Mark McNair        David Wall
  851.   Richard Fritz       Pete Mellor        Bob Williams
  852.   Marcelo A. Gallardo Dave Miller        Steve Woodyatt
  853.   Adam Garrett        Robert Morris      Michael A. Crowley
  854.  
  855. And many others... Our thanks to all!
  856.  
  857. Pine files and documentation are available via FTP or WWW:
  858.   ftp://ftp.cac.washington.edu/pine
  859.   http://www.cac.washington.edu/pine
  860.  
  861. In particular, the latest version of Pine source code is available via
  862. anonymous FTP from Internet host ftp.cac.washington.edu in the file
  863. /pine/pine.tar.Z.
  864.  
  865. Please send comments and correspondence to: pine@cac.washington.edu
  866.  
  867. ---------------------
  868. | (7) LEGAL NOTICES |
  869. ---------------------
  870.  
  871. Pine and Pico are registered trademarks of the University of Washington.
  872. No commercial use of these trademarks may be made without prior written
  873. permission of the University of Washington.
  874.  
  875. Pine, Pico, and Pilot software and its included text are Copyright
  876. 1989-1996 by the University of Washington. 
  877.  
  878. Use of Pine/Pico/Pilot:  You may compile and execute these programs for
  879. any purpose, including commercial, without paying anything to the
  880. University of Washington, provided that the legal notices are maintained
  881. intact and honored.
  882.  
  883. Local modification of this release is permitted as follows, or by mutual
  884. agreement: In order to reduce confusion and facilitate debugging, we
  885. request that locally modified versions be denoted by appending the letter
  886. \"L\" to the current version number, and that the local changes be
  887. enumerated in the integral release notes and associated documentation.
  888.  
  889. Redistribution of this release is permitted as follows, or by mutual
  890. agreement:
  891.  (a) In free-of-charge or at-cost distributions by non-profit concerns;
  892.  (b) In free-of-charge distributions by for-profit concerns;
  893.  (c) Inclusion in a CD-ROM collection of free-of-charge, shareware, or
  894.      non-proprietary software for which a fee may be charged for the 
  895.      packaged distribution.
  896.  
  897. UW encourages unrestricted distribution of individual patches to the Pine
  898. system.  By \"patches\" we mean \"difference\" files that can be applied
  899. to the UW Pine source distribution in order to accomplish bug fixes, minor
  900. enhancements, or adaptation to new operating systems.  Submission of these
  901. patches to UW for possible inclusion in future Pine versions is also
  902. encouraged.
  903.  
  904. The above permissions are hereby granted, provided that the Pine and Pico
  905. copyright and trademark notices appear in all copies and that both the
  906. above copyright notice and this permission notice appear in supporting
  907. documentation, and that the name of the University of Washington not be
  908. used in advertising or publicity pertaining to distribution of the
  909. software without specific, prior written permission.  This software is
  910. made available \"as is\", and
  911.  
  912. THE UNIVERSITY OF WASHINGTON DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED,
  913. WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED
  914. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND IN
  915. NO EVENT SHALL THE UNIVERSITY OF WASHINGTON BE LIABLE FOR ANY SPECIAL,
  916. INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  917. LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, TORT
  918. (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF OR IN
  919. CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 
  920.  
  921. <End of Release Notes>
  922. ===== main_menu_tx ======
  923.           GENERAL INFORMATION ON THE PINE MESSAGE SYSTEM
  924.              Version ___version (built ___cdate)
  925.                         University of Washington
  926.  
  927.  
  928. TABLE OF CONTENTS
  929.  
  930.         o Introduction
  931.         o Pine Help
  932.         o Local Support Contacts
  933.         o Giving Commands in Pine
  934.         o Status Line
  935.         o Main Menu Commands
  936.         o Command Line Options
  937.         o Pine Configuration
  938.         o Reading News
  939.         o Reporting Problems
  940.  
  941. ----------------
  942. | Introduction |
  943. ----------------
  944.  
  945. PINE(tm) is the University of Washington's \"Program for Internet News and
  946. Email\".  It is intended to be an easy-to-use program for sending,
  947. receiving, and filing Internet electronic mail messages and bulletin board
  948. (Netnews) messages. Pine supports the following Internet protocols and
  949. specifications:
  950.                 SMTP  - Simple Mail Transport Protocol
  951.                 NNTP  - Network News Transport Protocol
  952.                 MIME  - Multipurpose Internet Mail Extensions
  953.                 IMAP  - Internet Message Access Protocol
  954.  
  955. MIME allows you to attach any kind of file to your message, provided that
  956. your recipient also has MIME-capable mail software (which is readily
  957. available for most types of computers, although some proprietary mail
  958. systems do not yet support MIME).  IMAP allows access to mailboxes on
  959. remote mailservers as if they were local.
  960.  
  961. Although originally designed for inexperienced email users, Pine has
  962. evolved to support many advanced features.  There are an ever-growing
  963. number of configuration and personal-preference options, though which of
  964. them are available to you is determined by your local system managers. 
  965.  
  966. -------------
  967. | Pine Help |
  968. -------------
  969.  
  970. Pine help is context-sensitive.  In other words, each Pine screen you use
  971. will have its own help text, explaining the choices available for that
  972. screen.  This particular Help section is unusual in that it will not only
  973. describe the specific commands available from the MAIN MENU, but also
  974. provide an overview of Pine operation.
  975.  
  976. In addition to this general help on Pine, Release Notes on the current
  977. Pine version are also available from the MAIN MENU.  Press {F9:R} to
  978. browse the release notes.  These include changes since the last release,
  979. notes for PC-Pine, configuration information, the history of the Pine
  980. project, credits, and legal notices.
  981.  
  982. Pine files and documentation are available via FTP or WWW:
  983.   ftp://ftp.cac.washington.edu/pine
  984.   http://www.cac.washington.edu/pine
  985.  
  986. For a copy of the current Pine \"Frequently Asked Questions\" (FAQ) list,
  987. send an empty message to pine-faq@cac.washington.edu  --or, if it is
  988. available at your site, use the Setup/Update command under the Main Menu.
  989.  
  990. If you would like to print *all* of Pine's internal help text for a little
  991. light bedtime reading, then press {F12:Z} now.  (This assumes that the
  992. copy of Pine you are using has been properly configured for printing
  993. at your site.)
  994.  
  995. --------------------------
  996. | Local Support Contacts |
  997. --------------------------
  998.  
  999. ___include /usr/local/lib/pine.info
  1000.  
  1001.         [ No local information available. ]
  1002.  
  1003. ___end_include
  1004.  
  1005. ---------------------------
  1006. | Giving Commands in Pine |
  1007. ---------------------------
  1008.  
  1009. COMMANDS: The bottom two lines of the screen are always used to list the
  1010. commands you can give.  You press the keys that are highlighted to give
  1011. the command.  The commands for getting help and going back to the main
  1012. menu are always present (except when viewing help as you are now).
  1013.  
  1014. {:OTHER COMMANDS: The \"Other Commands\" function changes the keys you see}
  1015. {:at the bottom of any screen.  In some cases there are 3 different pages}
  1016. {:of keys which it toggles through.  ALL COMMANDS ARE ACTIVE, even if they}
  1017. {:are not currently showing at the bottom of your screen.  In other words,}
  1018.  
  1019. {:you NEVER need to prefix a command key with the 'O' key.}
  1020.  
  1021. {:CONTROL KEY:  When composing mail and in a few other places in Pine you}
  1022. {:have to use Control keys which means pressing the control key and the }
  1023. {:letter indicated at the same time.  This is usually shown with a \"^\" in}
  1024. {:front of the letter.  On some systems, certain control characters are}
  1025. {:intercepted before they get to Pine.  As a work-around, you can press}
  1026. {:the ESCAPE key twice followed by the desired key.  For example, if }
  1027. {:Control-O (^O) does not work on your system, try typing \"ESC ESC O\".}
  1028.  
  1029. PAGING UP/DOWN: The \"+\" and \"-\" keys are used for moving to the next
  1030. or previous page.  The space bar is a synonym for \"+\".  You may also use
  1031. Ctrl-V to page down and Ctrl-Y to page up as you do in the message
  1032. composer.  On screens with a WhereIs (search) command, W or Ctrl-W followed
  1033. by Ctrl-V will move to the bottom of the message or list, and W or Ctrl-W
  1034. followed by Ctrl-Y will move to the top of the message or list.
  1035.  
  1036. RETURN KEY: The return key is usually a synonym for a frequently used
  1037. command.  When viewing a message, there is currently not a default
  1038. command, so RETURN does nothing; when in the index, it is synonymous with
  1039. \"view msg\". In the key menu at the bottom of the screen, whatever is
  1040. enclosed in square brackets [] is the same as the return key.
  1041.  
  1042. CONTROL KEYS NOT USED BY PINE:  Most commands in Pine are single letters,
  1043. with --we hope-- some mnemonic value, but in places where Pine is expecting
  1044. text input, e.g. in the composer or at prompts for file/folder names,
  1045. control keys must be used for editing and navigation functions.
  1046.  
  1047. Pine has used nearly all the control keys available.  There are, however,
  1048. certain control keys that are reserved by other programs or for technical
  1049. reasons.  Pine does not use any of these keys:
  1050.                 Ctrl-S    Used by Unix as \"stop output\"
  1051.                 Ctrl-Q    Used by Unix as \"resume output\"
  1052.                 Ctrl-]    Often used by Telnet as escape key
  1053.                 Ctrl-\\   Often used by Unix as \"Abort\"
  1054.                 ESC       Conflicts with sequences used for arrow keys
  1055.  
  1056. NOTE: by default, Pine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
  1057. and XON), as normal characters, even though Pine does not use them.
  1058. However, the printer, modem, or communication software you are using may
  1059. be configured for \"software flow control\" which means that XON/XOFF must
  1060. be treated as special characters by the operating system.  If you see
  1061. messages such as \"^X not defined for this screen\", then your system is
  1062. probably using software flow control. In this case you will need to set
  1063. the \"preserve-start-stop-characters\" feature.  If you *do* set this
  1064. feature, be advised that if you accidentally hit a Ctrl-S, Pine will
  1065. mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
  1066. and see if that puts things right.  Printing via the \"attached-to-ansi\"
  1067. option will automatically enable software flow-control handling for the
  1068. duration of the printing.
  1069.  
  1070. REPAINTING THE SCREEN: Sometimes what is displayed on the screen will be
  1071. incorrect due to noise on the phone line or other causes and you will want
  1072. to repaint the whole screen to make it correct.  You can use the Ctrl-L
  1073. command to do this.  It never hurts to do it when in doubt.
  1074.  
  1075. ---------------
  1076. | Status Line |
  1077. ---------------
  1078.  
  1079. The top line of the screen is Pine's status line.  It will always display
  1080. the current version of Pine and will also convey information about the
  1081. status of the program.  This is where you look to find out what
  1082. collection, folder and message number is active.
  1083.  
  1084. If the top line says \"READONLY\" it means that the open folder (typically
  1085. your INBOX) is \"locked\" by another mail session -- most likely a more
  1086. recent session of Pine has taken the INBOX lock.
  1087.  
  1088. If the top line says \"CLOSED\" it means that you are trying to access a
  1089. folder on a remote mail server, and for some reason, communication with
  1090. the mail server has either been lost, or never successfully established.
  1091. This can be a result of trying to open a non-existent folder, or one
  1092. stored on an invalid or non-operational server, or it can mean that Pine
  1093. has been suspended for more that 30 minutes while accessing a remote mail
  1094. server.
  1095.  
  1096. ----------------------
  1097. | Main Menu Commands |
  1098. ----------------------
  1099.  
  1100. {Available Commands -- Group 1          Available Commands -- Group 2   :General Pine Commands  MAIN MENU Screen Commands}
  1101. {------------------------------         ------------------------------  :---------------------  -------------------------}
  1102. {F1  Show this help text                F1  Show this help text         :?  Show help text      O  Show all Other available commands}
  1103. {F2  Show all other available commands  F2  Show other commands         :C  Compose a message   P  Select Previous command up on menu}
  1104. {F3  Quit Pine                                                          :I  FOLDER INDEX screen N  Select Next command down on menu}
  1105. {F4  Execute current MAIN MENU command  F4  Compose a message           :L  FOLDER LIST screen  R  Display Pine Release Notes}
  1106. {F5  Select previous command up on menu F5  FOLDER LIST screen          :A  ADDRESS BOOK screen K  Lock Keyboard }
  1107. {F6  Select next command down on menu   F6  Goto a specified folder     :S  SETUP functions     G  Goto a specified folder}
  1108. {                                       F7  FOLDER INDEX screen         :Q  Quit Pine}
  1109. {F9  Display Pine release notes         F9  SETUP menus :}
  1110. {F10 Lock keyboard                      F10 ADDRESS BOOK screen :}
  1111.  
  1112. NOTE: The availability of certain commands (e.g. some of the options under
  1113. SETUP) is determined by Pine configuration files and system capabilities.
  1114. At some sites, certain commands may not be available due to security or
  1115. support concerns.
  1116.  
  1117. The \"COMPOSE MESSAGE\" command (available on MAIN MENU, FOLDER LIST,
  1118. FOLDER INDEX, and MESSAGE TEXT screens) takes you into the Pine message
  1119. composer and permits you to create and send a new message.
  1120.  
  1121. The \"FOLDER INDEX\" command (available on MAIN MENU, FOLDER LIST, and
  1122. MESSAGE TEXT screens) takes you to the FOLDER INDEX screen which displays
  1123. a summary caption for each message in the currently-open folder. One
  1124. message will be highlighted; this is the \"Current\" message.  The message
  1125. commands available from this screen (e.g. View, Reply, Forward, Delete,
  1126. Print, Save, etc) apply to the current message.
  1127.  
  1128. The \"FOLDER LIST\" command (available on MAIN MENU, FOLDER INDEX, and
  1129. MESSAGE TEXT screens) takes you to the FOLDER LIST screen which displays
  1130. the names of all your message folders and allows you to view, rename,
  1131. delete, and add folders.  You can open (view) a different folder than the
  1132. one currently open by highlighting the desired one (using the arrow keys
  1133. or their control-key equivalents) and pressing RETURN.  If you have
  1134. multiple folder collections defined (see the Help text for the FOLDER LIST
  1135. screen to learn more about Collections), you may need to press RETURN to
  1136. expand the collection and display all of the folders in it.
  1137.  
  1138. The \"ADDRESS BOOK\" command (available only from the MAIN MENU) takes you
  1139. to the ADDRESS BOOK management screen.  From here, your personal address
  1140. book(s) may be updated.
  1141.  
  1142. The \"SETUP\" command (available only from the MAIN MENU) prompts you for
  1143. one of several configuration screens, including the SETUP CONFIGURATION 
  1144. screen, by which you may activate optional Pine features.
  1145.  
  1146. Also available from the Main Menu, but only displayed on the Key Menus at
  1147. the bottom of the screen, are the following commands:
  1148.  
  1149. The \"Goto\" command (available on MAIN MENU, FOLDER LIST, FOLDER INDEX,
  1150. and MESSAGE TEXT screens) lets you jump directly to a new folder without
  1151. having to use the Folder List display. It will prompt you for the name of
  1152. the desired folder and, if you have multiple folder collections defined,
  1153. allow you to rotate through them.  However, if the folder is outside of your
  1154. defined collections, you are going to have to enter the exact folder
  1155. location using the correct syntax for a remote folder and/or the
  1156. fully-qualified path name.
  1157.  
  1158. The \"Release Notes\" command displays information about this version of
  1159. Pine, as well as historical and legal notes.
  1160.  
  1161. The \"Keyboard Lock\" command allows your Pine session to be protected
  1162. during a temporary absence from your terminal.
  1163.  
  1164. The \"Report Bug\" command does the obvious thing; please see section (10)
  1165. below.  This command is also available from any help screen (including
  1166. this one.)
  1167.  
  1168. ------------------------
  1169. | Command Line Options |
  1170. ------------------------
  1171.  
  1172. Possible Starting Arguments for Pine program:
  1173.  
  1174.         Argument                Meaning
  1175.  
  1176.         <address>...    Go directly into composer with given address
  1177.         -a              Special anonymous mode for UWIN*
  1178.         -c              Context # for interpreting -f argument
  1179.                          0=none, 1=incoming, 2=deflt coll'n, 3=next coll'n
  1180.         -d n            Debug - set debug level to 'n'
  1181.         -f <folder>     Folder - open <folder> in default collection
  1182.         -F <file>       File - open and view text <file>
  1183.         -h              Help - give this list of options
  1184.         -i              Index - Go directly to index, bypassing main menu
  1185.         -I <key_list>   Initial keystrokes to be executed
  1186.         -k              Keys - Force use of function keys
  1187.         -l              List - Expand List of folder collections by default
  1188.         -n <number>     Entry in index to begin on
  1189.         -nr             Special restricted mode for UWIN*
  1190.         -o              ReadOnly - Open first folder read-only
  1191.         -p <file>       Use <file> in place of .pinerc file
  1192.         -P <file>       Use <file> in place of pine.conf file
  1193.         -r              Restricted/demo mode
  1194.         -z              Suspend - allow use of ^Z suspension
  1195.         -sort <sort>    Sort - Specify sort order of Folder Index:
  1196.                    (Subject, OrderedSubj, Arrival, Date, From, Size, /reverse)
  1197.         -conf           Configuration - Output fresh global config to stdout
  1198.         -create_lu <addrbk> <sort>  Create auxiliary look-up file and
  1199.                         sort <addrbk> by <sort>.  For creating global addrbk.
  1200.         -pinerc <file>  Configuration - Put fresh pinerc config in <file>
  1201.         -<option>=<value>       Assign <value> to the pinerc option <option>
  1202.                                 e.g. -signature-file=sig1
  1203.                                 (NOTE: feature-list is additive)
  1204.  
  1205.                      * UWIN = University of Washington Information Navigator
  1206.  
  1207. ----------------------
  1208. | Pine Configuration |
  1209. ----------------------
  1210.  
  1211. Unless it has been administratively disabled, the Setup command on the
  1212. MAIN MENU has a \"Config\" subcommand which will allow you to modify
  1213. Pine's behavior by setting or unsetting various features, defining folder
  1214. collections, etc.  These settings are stored in your personal \"pinerc\"
  1215. configuration file, but on shared systems these settings may be
  1216. over-ridden by a system-wide control file (due to local site security or
  1217. support policies).  A global pine configuration file can also be used to
  1218. set default values for all Pine users on a particular system.
  1219.  
  1220. ----------------
  1221. | Reading News |
  1222. ----------------
  1223.  
  1224. BACKGROUND
  1225.  
  1226. Pine can read and post Internet news (NetNews or USENET) groups, using the
  1227. same commands as for mail.  If you do not already have a news state
  1228. (\"newsrc\") file, Pine will create one for you, and you can add newsgroups
  1229. to it using the \"Add\" command in the FOLDER LIST screen. Pine can use the
  1230. same newsrc as other Unix newsreaders, thus allowing you to switch between
  1231. Pine and other newsreaders; however, Pine uses the information in the file
  1232. in a slightly different way than other newsreaders.
  1233.  
  1234. CONFIGURATION
  1235.  
  1236. Pine can access news folders in any one of three different ways:
  1237.  
  1238.         REMOTE NNTP:  Using the Network News Transport Protocol (NNTP) to
  1239. access news on a remote news server.  In this case the newsrc file is
  1240. stored on the machine where Pine is running.  Simply specify the name of
  1241. the news server as your nntp-server:
  1242.                 nntp-server      = news.nowhere.edu
  1243. If you do this (and do not explicitly set the news-collections variable),
  1244. Pine will automatically use *{{:{}news.nowhere.edu}[] for the value of
  1245. the news-collections variable.
  1246.  
  1247.         REMOTE IMAP:  Using the Internet Message Access Protocol (IMAP) to
  1248. access news on a remote news server.  In this case, your newsrc file is
  1249. stored on the news server, in your home directory, so you must have an
  1250. account on the news server, but you would be running Pine on a different
  1251. machine.  The news server must be running an IMAPd server process. Specify
  1252. a remote news-collection in the SETUP CONFIGURATION:
  1253.                 news-collections = News *{{:{}news.nowhere.edu}[]
  1254.  
  1255.         LOCAL:  Using local file access to the news database.  In this
  1256. case, your newsrc file is stored on the news server, in your home
  1257. directory, so you must have an account on the news server, and you would
  1258. be running Pine on the same machine.  Specify a local news-collection in
  1259. the SETUP CONFIGURATION:
  1260.                 news-collections = News *[]
  1261.  
  1262. In the first two examples, the hostname \"news.nowhere.edu\" should be
  1263. replaced with the domain name of your local news server.  For Unix Pine,
  1264. these entries can be placed in either the system-wide or your personal
  1265. configuration file.
  1266.  
  1267. If you are a PC-Pine user, either option 1 (NNTP) or option 2 (IMAP) is
  1268. possible.  If you don't have an account on the news server, or if the news
  1269. server is not running an IMAP daemon, then you must use NNTP.  In
  1270. this case, your Unix .newsrc file can be transferred to your PC.  A good
  1271. place to put it would be in the same directory as your PINERC file, under
  1272. the name \\NEWSRC, but you can specify a different location via Pine's
  1273. Setup/Config screen.
  1274.  
  1275. A future version of PC-Pine will be able to access and update a newsrc
  1276. file stored on a Unix host, so that it will be possible to alternate
  1277. between PC-Pine and Unix-based newsreaders.
  1278.  
  1279. READING NEWS
  1280.  
  1281. Once defined in the .pinerc (or the global pine.conf) file, the news
  1282. folder collection can be accessed either via the FOLDER LIST screen, or
  1283. via the GOTO command.
  1284.  
  1285. Pine uses the same commands for manipulating news folders as for mail
  1286. folders.  This means, for example, that when you are done with a message,
  1287. you would use \"D\" to mark it as Deleted (or Dismissed, if you prefer.)
  1288. This \"mail-like\" behavior differs from that of most newsreaders, wherein
  1289. a message is implicitly dismissed after you have looked at it once. We
  1290. strongly believe that Pine should offer as much consistency as possible
  1291. between mail and news, so the mail paradigm --wherein a message does not
  1292. magically disappear without explicit action by the user-- is used for news
  1293. as well.
  1294.  
  1295. News folders are actually Read-Only, but the newsrc file allows Pine to
  1296. keep track of which messages you have dismissed (marked as Deleted) just
  1297. as in a regular mail folder. The difference is that, although messages
  1298. marked as Deleted will show up in the Index (just as mail messages do
  1299. until an eXpunge), you cannot expunge news messages.  However, you can use
  1300. the \"eXclude\" (X) command in order to suppress from the Folder Index
  1301. messages that are so marked.  Also, whenever you open a newsgroup folder,
  1302. messages marked Deleted are already excluded from the Index by default.
  1303. The \"unexclude\" (&) command will restore them to the Folder Index.
  1304.  
  1305. If you answer a message in a news folder, the index view will show the
  1306. \"A\" flag as usual; but the newsrc file has no way of storing this flag,
  1307. so it will not be preserved across sessions.  The Deleted flag is the only
  1308. one that is preserved between sessions.  If you Reply to a newsgroup
  1309. message and say you want to reply to all recipients, Pine will ask if
  1310. you want to post the message to all the newsgroups listed in the original
  1311. message.
  1312.  
  1313. If you would like Pine to mark more-or-less recent news messages as
  1314. \"New\", then set the \"news-approximates-new-status\" feature.  This will
  1315. cause messages after the last one you have marked as Deleted to appear
  1316. with \"N\" status in the Folder Index.  The \"N\" status often makes it
  1317. easier to distinguish later news articles from those you've previously
  1318. seen, but not yet disposed of via the \"D\" key.  Note that this is an
  1319. approximation, not an exact record of which messages you have not seen.
  1320.  
  1321. A frequent operation in news-reading is \"catching up\"... that is,
  1322. getting rid of all the messages in the news group so that you can \"start
  1323. fresh\".  At the moment, the easiest way to do this in Pine is via the
  1324. Select command.  You would enter the following four keystrokes: ;aad
  1325. Note that the \"enable-aggregate-command-set\" feature must be enabled
  1326. before you can use the Select command.
  1327.  
  1328. ----------------------
  1329. | Reporting Problems |
  1330. ----------------------
  1331.  
  1332. There are now literally millions of Pine users in over 50 countries.
  1333. The Pine development team has no funding to provide support to anyone
  1334. outside of the University of Washington.  However, we certainly want Pine
  1335. to be the best tool it can be, so we do want to know about problems. We
  1336. ask that you first read the relevant help screens, if any, and then seek
  1337. assistance from your own support staff.  Once you are sure that your
  1338. difficulty is not a local configuration problem, use the \"{F11:B} Report
  1339. Bug\" command (available from any HELP screen) to let us know about it.
  1340. You may also use the Report Bug command to request local assistance
  1341. or to send a suggestion to the developers.
  1342.  
  1343. Please note: Pine has been adapted to several other operating systems
  1344. besides those directly supported by the University of Washington. 
  1345. Inquiries about these other ports (e.g. VMS and AmigaDOS) should be
  1346. directed to the individual or group that did the adaptation. 
  1347.  
  1348.                         Pine Development Team <pine@cac.washington.edu>
  1349.                         Computing & Communications
  1350.                         University of Washington
  1351.                         Seattle, WA  98195
  1352.  
  1353. <End of Main Menu Help>
  1354. ============= h_mail_index   ========================
  1355.                          FOLDER INDEX COMMANDS
  1356. {Available  Commands -- Group 1         Available Commands -- Group 2         :Navigating the List of Messages             Operations on the Current Message}
  1357. {-------------------------------        -----------------------------         :-------------------------------             ---------------------------------}
  1358. {F1  Show Help Text                     F1  Show Help Text                    : P   Move to the previous message           V  View                 Y  Print}
  1359. {F2  Toggle to see more commands        F2  Toggle to see more commands       : N   Move to the next message               R  Reply to message     F  Forward}
  1360. {F3  MAIN MENU Screen                   F3  Quit Pine                         : -   Show previous screen of messages       D  Mark for deletion      }
  1361. {F4  View current message               F4  Compose a message                 :Spc  Show next screen of messages           U  Undelete (remove deletion mark)}
  1362. {F5  Move to previous message           F5  FOLDER LIST screen                : J   Jump to a specific message             T  Take Address into Address Book}
  1363. {F6  Move to next message               F6  Goto a specified folder           : W   Whereis -- search for a                S  Save into an email folder}
  1364. {F7  Show previous screen of messages   F7  Zoom                              :     specific message                       E  Export as a plain text file}
  1365. {F8  Show next screen of messages       F8  Whereis                           : |   Pipe to a Unix Command                 B  Bounce               *  Flag}
  1366. {F9  Mark message for deletion          F9  Print message                     :Miscellaneous Operations}
  1367. {F10 Undelete (remove delete mark)      F10 Take address into address book    :----------------------------}
  1368. {F11 Reply to message                   F11 Save message into an email folder : G   Goto a specified folder     General Pine Commands }
  1369. {F12 Forward                            F12 Export message into a plain file  : $   Sort order of index         --------------------- }
  1370. {                                                                             : H   Full header mode            O  Show all other available commands }
  1371. {Available Commands -- Group 3                                                : X   Expunge/Exclude             ?  Show Help text     Q Quit Pine }
  1372. {------------------------------                                               : Z   Zoom          A Apply       M  MAIN MENU Screen   L FOLDER LIST screen}
  1373. {F3  Expunge/Exclude        F7 Jump to message   F10 Bounce (remail) msg      :Tab  Next-New      ; Select      C  Compose a new message }
  1374. {F4  Select     F5  Apply   F8 Next New          F11 Flag message as important:}
  1375. {F6  Sort order of index    F9 Full Header Mode  F12 Pipe to a Unix command   :}
  1376.  
  1377. NOTE: The presence or absence of the following commands is determined by
  1378. \"feature-list\" options in your Pine configuration.  Also, some of these
  1379. commands may be administratively disabled by your system manager; if they
  1380. don't work, please check with your local help desk before reporting a bug.
  1381.  
  1382.     o Header Mode (toggle between display of full or minimal headers)
  1383.     o Select (tag messages for aggregate operations)
  1384.     o Apply (apply a command to multiple previously-selected messages)
  1385.     o Flag (mark message as important or set other message status flags)
  1386.     o Zoom (show only pre-selected messages)
  1387.     o Bounce (re-mail message to correct recipient)
  1388.     o Pipe message to a Unix command
  1389.  
  1390. The \"Pipe message to a Unix command\" command is not available in PC-Pine.
  1391.  
  1392. -------------------------------------------
  1393. | Description of the FOLDER INDEX Screen  |
  1394. -------------------------------------------
  1395.  
  1396. The Folder Index displays the headers or summary information of each
  1397.  message in the current folder.  This is useful if you want to quickly
  1398. scan new messages, or find a particular message without having to go
  1399. through the text of each message, or to quickly get rid of junk
  1400. messages, etc.  If the list is too long to fit on one screen, you can
  1401. page up and down in the list with the {F7:-}/{F8:SPACE} commands.  The
  1402. current message is always highlighted, and its message number is shown
  1403. in the status line.  Each message line contains the following columns: 
  1404.  
  1405.   STATUS: The markings on the left side of the message tell you about its
  1406. status.  You may see one or more of the following codes on any given
  1407. message:
  1408.  
  1409.    o \"D\" for Deleted.  You have marked this message for deletion but not
  1410.          yet eXpunged the folder.
  1411.    o \"N\" for New.  You have not looked at the text of the message yet.
  1412.    o \"A\" for Answered.  Any time you reply to a message it is considered
  1413.          to be answered.
  1414.    o \"+\" for direct-to-you.  The \"+\" indicates that a message was sent
  1415.         directly to your account, your copy is not part of a cc: or a
  1416.         mailing list.
  1417.    o \"X\" for selected.  You have selected the message by using the
  1418.         \"select\" command.  (Some systems may optionally allow selected
  1419.         messages to be denoted by the index line being displayed in bold
  1420.         type.)
  1421.    o \"*\" for Important.  You have previously used the \"Flag\" command
  1422.       to mark this message as \"important\".
  1423.  
  1424.   NUMBER: Messages in a folder are numbered, from one through the number
  1425. of messages in the folder, to help you know where you are in the folder.
  1426.  
  1427.   DATE SENT: The date the message was sent.  By default, messages are
  1428. ordered by arrival time, not by date sent.  Most of the time, arrival time
  1429. and date sent (effectively departure time) are similar.  Sometimes,
  1430. however, the index will appear to be out of order because a message took a
  1431. long time in delivery.
  1432.  
  1433.   SENDER: The name or email address of the sender.  If you are the sender,
  1434. then the first recipient's name is shown here.  In Newsgroups, if you are
  1435. the sender and there are no email recipients, the newsgroup name will be
  1436. listed. 
  1437.  
  1438.   SIZE: The number in parentheses is the number of characters in the message.
  1439.  
  1440.   SUBJECT: As much of the message's subject line as will fit on the screen.
  1441.  
  1442. ------------------------------
  1443. | Brief Command Explanations |
  1444. ------------------------------
  1445.  
  1446. REPLY AND FORWARD
  1447.  
  1448. Replying ({F11:R}) and Forwarding ({F12:F}) are your two alternatives for
  1449. following up on the message you are reading. You would use reply if you
  1450. want to get email back to the author of the message and/or the other
  1451. people who have already seen it.  You use forward if you want somebody new
  1452. to see the message.
  1453.  
  1454. In the normal case, the only thing that you must supply when forwarding a
  1455. message is the name/email address of the new recipient.  Pine will
  1456. include the text of the forwarded message.  Pine will also include any
  1457. attachments to the message if you have requested them.  There is space
  1458. above the forwarded text for you to include any comments.
  1459.  
  1460. When replying, you usually have to answer some questions.  If the message
  1461. is to multiple people and/or specified with a Reply-To: header, then you
  1462. will have to decide who should get the reply.  You also need to decide
  1463. whether or not to include the previous message in your reply.  Some of
  1464. this is configurable.  Specifically, see the include-header-in-reply and
  1465. include-text-in-reply configuration features.
  1466.  
  1467. Both the Reply and Forward commands react to the full header mode toggle.
  1468. If the full header mode is on, then all the header and delivery lines are
  1469. included with the text of the message in your reply/forward.
  1470.  
  1471. SAVE AND EXPORT
  1472.  
  1473. Export ({F12:E}) and Save ({F11:S}) are the two alternatives Pine gives
  1474. you to keep a copy of the message you are reading. If you want to keep the
  1475. message within Pine's email world, use \"save\"; if you want to use the
  1476. message in another program, use \"export\".
  1477.  
  1478. When you save a message, it is put into an existing folder or into a new
  1479. folder in one of your existing folder collections.  The message stays in
  1480. email format and can be read by Pine again.  Pine may use a special format
  1481. for its mail folders -- never edit a Pine folder by hand or with any
  1482. program other than Pine.  The exact behavior of the save command can be
  1483. configured with the save-will-quote-leading-froms, save-will-not-delete,
  1484. and save-will-advance feature list settings.
  1485.  
  1486. When you use export, the message is placed in a plain text file in your
  1487. home directory or current working directory, depending on the
  1488. use-current-dir configuration setting.  In the normal case, only minimal
  1489. headers are exported with the message; however, if the full header mode is
  1490. toggled on, then complete headers are exported along with the message
  1491. text.
  1492.  
  1493. TAKE ADDRESS
  1494.  
  1495. With the Take Address command, you can extract email addresses from an
  1496. incoming message and save them in an address book.  This is an easy way
  1497. to add to your address book and avoid having to remember the email
  1498. addresses of the people who write to you.
  1499.  
  1500. If the message is just to you individually, then you will only need to
  1501. provide a nickname.  If the message is more complicated (with more than
  1502. one recipient or an email list involved), then you will see an address
  1503. selection screen which lets you choose the address you want to save into
  1504. your address book, or add several of them to a personal address list.
  1505.  
  1506. HEADER MODE
  1507.  
  1508. Every email message comes with some header lines that you normally don't
  1509. see.  These include anywhere from 3-20 lines added by Internet mail
  1510. transport system to record the route your message took, for diagnostic
  1511. purposes.  These are normally of no import and simply add clutter, so Pine
  1512. suppresses them from MESSAGE TEXT display.  There is, however, a way to
  1513. reveal them.
  1514.  
  1515. The Header Mode ({F9:H}) command is a toggle which controls Pine's
  1516. handling of these header lines.  Normally, full headers is \"off\" and you
  1517. only see a few lines about who a message is to and who it is from.  When
  1518. you press {F9:\"H\"} to turn full headers on, Pine will show you the
  1519. normal header lines as well as delivery headers, comment headers and MIME
  1520. headers.
  1521.  
  1522. Several different Pine commands honor the header mode -- it affects how
  1523. messages are displayed, how they appear in Forward and Reply email, how
  1524. they are printed, how they are saved, and how they are exported.  In Unix
  1525. Pine, the Pipe command is also affected.
  1526.  
  1527. The presence or absence of the Header Mode command is determined by the
  1528. \"enable-full-header-cmd\" feature-list option in your Pine
  1529. configuration.
  1530.  
  1531. EXPUNGE/EXCLUDE
  1532.  
  1533. Expunge/Exclude is the command Pine uses to actually remove all messages
  1534. marked for deletion.  With regular email files, expunge literally deletes
  1535. the text from the current folder.  With newsgroups or shared mailboxes,
  1536. you don't have permission to actually remove the message, so it is an
  1537. exclude -- Pine removes the message from your view of the folder even
  1538. though it is not technically gone.
  1539.  
  1540. GOTO
  1541.  
  1542. Goto is the command which lets you bypass Pine's folder selection screens
  1543. and jump directly to a new folder.  You can select any folder in the
  1544. world: one in your current collection, one in a different collection or
  1545. one in a collection you've never even used before.
  1546.  
  1547. Pine will help you as much as possible to narrow in on the folder you want.
  1548. However, if the folder is outside of your defined collections, you are
  1549. going to have to enter the exact folder location using the correct syntax
  1550. for a remote folder and/or fully-qualified path name.
  1551.  
  1552. WHEREIS
  1553.  
  1554. The WhereIs command lets you search the FOLDER INDEX for a word.  It scans
  1555. through whatever you see, usually the name of the author and the subject
  1556. line.  WhereIs has special features to let you \"find\" the beginning of the
  1557. index (Ctrl-Y -- first message) or the end of the index (Ctrl-V -- last
  1558. message).  WhereIs can also be used as a quick way to select messages, see
  1559. below for more information on this.  Note that WhereIs does not see the 
  1560. \"X\" in column one of Index entries for \"selected\" messages.
  1561.  
  1562. JUMP
  1563.  
  1564. This is Pine's way of allowing you to go straight to a specific message.
  1565. Just press {F7:\"J\"} and then enter the message number.  Pine can also be
  1566. configured such that typing in any number automatically jumps you to that
  1567. message (enable-jump-shortcut in the SETUP CONFIGURATION).
  1568.  
  1569. SORT
  1570.  
  1571. In Pine's generic configuration, messages are presented in the order in
  1572. which they arrive.  This default can be changed in the SETUP CONFIGURATION.
  1573. You can also re-sort the folder on demand with the sort ({F6:$}) command.
  1574. Your sorting options are: Subject, Arrival, From, Date, siZe,
  1575. OrderedSubject and Reverse.
  1576.  
  1577. Some of the subtleties: sorting by subject will group all messages with
  1578. the same subject together and then puts the groups in alphabetical order.
  1579. Sorting by \"ordered subject\" does a grouping intended to simulate a
  1580. \"threaded\" sort, and then presents each \"thread\" in order of the date
  1581. of the first message in the group.  Reverse simply reverses whatever the
  1582. current sort order is.
  1583.  
  1584. Sorting a folder does not actually rearrange the way the folder is saved,
  1585. it just re-arranges how the messages are presented to you.  This means
  1586. that Pine has to do the work of sorting every time you change sort order.
  1587. Sometimes, especially with PC-Pine or with large folders, this could take
  1588. a while.
  1589.  
  1590. BOUNCE
  1591.  
  1592. The bounce ({F10:B}) command allows you to re-send, or \"remail\", a
  1593. message, as if you were never in the loop.  It is analogous to crossing
  1594. out your address on a postal letter, writing a different address on the
  1595. envelope, and putting it into the mailbox. Bounce is used primarily to
  1596. redirect email which was sent to you in error.  Also, some owners of email
  1597. lists need the bounce command to handle list traffic.
  1598.  
  1599. The presence or absence of the Bounce command is determined by the
  1600. \"enable-bounce-cmd\" feature-list option in your Pine configuration. Note
  1601. that Bounce may be administratively disabled by your system manager; if it
  1602. doesn't work, please check with your local help desk before reporting a
  1603. bug.
  1604.  
  1605. FLAG
  1606.  
  1607. Flag ({F11:*}) is the command which allows users to manipulate the status
  1608. flags which appear on the left side of the FOLDER INDEX screen.  The most
  1609. common use of this is to mark a message as important. This is something of
  1610. a note to yourself to get back to that message.  You can also use the flag
  1611. command to set (or unset) the flags which indicate that a message is new,
  1612. read or answered.
  1613.  
  1614. The availability of the flag command is determined by the
  1615. \"enable-flag-cmd\" feature-list option in your Pine configuration. Also,
  1616. Flag may be administratively disabled by your system manager; if it
  1617. doesn't work, please check with your local help desk before reporting a
  1618. bug.
  1619.  
  1620. NEXT NEW (TAB) COMMAND
  1621.  
  1622. When you press the TAB key, Pine advances to the next \"interesting\"
  1623. message.  When you are using Pine to read email, that message is the next
  1624. message in the folder which you have not read before, or that you have
  1625. previously flagged as Important.  When reading news folders, the next
  1626. \"interesting\" message is the next one that you have not yet deleted.
  1627.  
  1628. SELECTING: SELECT AND WHEREIS/SELECT
  1629.  
  1630. Aggregate operations give you the ability to process a group of messages
  1631. at once.  Acting on multiple messages requires two steps: (1) selecting a
  1632. set of messages and then (2) applying a command to that set. The first
  1633. part is handled by the select ({F4:\";\") command.  Select allows you to
  1634. select messages based on their status (read, answered, etc.), contents
  1635. (including fielded selections on header lines) or date.  You also get
  1636. certain quick options to select a specific message or range of messages,
  1637. to select the current message or to select all messages.
  1638.  
  1639. After you have an initial selection, the select command changes.  It gives
  1640. you selection \"alteration\" options: unselect all, unselect current,
  1641. broaden (implements a logical OR), and narrow (implements a logical AND).
  1642. You are allowed to use select as many times as you need to get the
  1643. selected set right.
  1644.  
  1645. Also, the WhereIs ({F8:W}) command has a new feature (Ctrl-X) to
  1646. select all the messages which match the WhereIs search. WhereIs searches
  1647. through just the text which appears on the FOLDER INDEX.
  1648.  
  1649. The availability of the aggregate operations commands is determined by the
  1650. \"enable-aggregate-command-set\" feature-list option in your Pine
  1651. configuration.  Note that aggregate commands may be administratively
  1652. disabled by your system manager;  if they don't work, please check with
  1653. your local help desk before reporting a bug.
  1654.  
  1655. APPLY
  1656.  
  1657. Apply ({F5:A}) is the second step of most aggregate operations.  Apply
  1658. becomes active any time there is a defined set of selected messages.  The
  1659. following commands can be applied to a selected message set: delete,
  1660. undelete, reply, forward, print, take address, save, export, flag, and (on
  1661. Unix Pine) pipe to Unix command.
  1662.  
  1663. The behavior of some of these commands in an aggregate sense is not easy to
  1664. explain.  Try them out to see what they do.
  1665.  
  1666. ZOOM
  1667.  
  1668. Another action you might want to take on a set of selected messages is to
  1669. zoom in on them.  Like Apply, Zoom only becomes active when messages have
  1670. been selected.  Zoom ({F7:Z}) is a toggle command which allows you to
  1671. zoom-in (and only to see the selected messages) and zoom-out (to see all
  1672. messages in the folder).  Neither apply nor zoom removes the markings which
  1673. define the selected set; you need to use a select (\";\") command in order
  1674. to do this.
  1675.  
  1676. <End of help on this topic>
  1677. ============= h_simple_index   ========================
  1678.         POSTPONED MESSAGE SELECTION COMMANDS
  1679.  
  1680. Navigating the List of Messages               General Pine Commands
  1681. -------------------------------               ---------------------
  1682.  {F5 : P }  Move to previous message                {F1 : ? }  Show this help text
  1683.  {F6 : N }  Move to next message
  1684.  {F7 : - }  Show previous screen of messages
  1685.  {F8 :Spc}  Show next screen of messages
  1686.  
  1687. Message Selection Commands
  1688. --------------------------
  1689.  {F3 : E }  Exit the Message Select menu (canceling Send command)
  1690.  {F4 : S }  Select the currently highlighted message
  1691.  {F9 : D }  Mark the currently highlighted message as deleted
  1692.  {F10: U }  Undelete (remove deletion mark from) the highlighted message
  1693.  
  1694. ------------------------------------------------------
  1695. | Description of the Select Postponed Message Screen |
  1696. ------------------------------------------------------
  1697.  
  1698. This screen allows you to select one of several previously postponed
  1699. messages in order to continue composition.  Your options are very limited
  1700. -- the screen is not meant to let you manipulate these messages.  However,
  1701. you may now delete messages from this list.  Once you choose a message,
  1702. Pine reads it in and puts you into the regular message composer.
  1703.  
  1704. Messages do not stay in this postponed state automatically.  If you select
  1705. a message and then want to postpone it again, use the normal postpone
  1706. (Ctrl-O) command in the composer.
  1707.  
  1708. If you exit this screen without selecting a message, the Compose command
  1709. which got you here is canceled.  Other than messages explicitly marked
  1710. \"Deleted\", no messages will be removed.
  1711.  
  1712. <End of help on this topic>
  1713. ============= h_mail_view   ========================
  1714.                         MESSAGE TEXT COMMANDS
  1715. {Available  Commands -- Group  1        Available Commands -- Group 2   :Navigating the List of Messages        Operations on the Current Message}
  1716. {-------------------------------        ------------------------------  :-------------------------------        ---------------------------------}
  1717. {F1  Show Help Text                     F1  Show Help Text              : P     Display previous message        V  View attachment      Y  Print}
  1718. {F2  Toggle to see more commands        F2  Toggle to see more commands : N     Display next message            R  Reply to message     F  Forward}
  1719. {F3  MAIN MENU Screen                   F3  Quit Pine                   : -     Show previous page of this msg  D  Mark for deletion      }
  1720. {F4  View attachment                    F4  Compose a message           :Spc    Show next page of this msg      U  Undelete (remove deletion mark)}
  1721. {F5  Display previous message           F5  FOLDER LIST screen          : J     Jump to a specific message      T  Take Address into Address Book}
  1722. {F6  Display next message               F6  Goto a specified folder     :                                       S  Save into an email folder}
  1723. {F7  Previous screen of this message    F7  FOLDER INDEX screen         :                                       E  Export as a plain text file}
  1724. {F8  Next screen of this message        F8  Whereis                     :                                       |  Pipe to a Unix Command}
  1725. {F9  Mark message for deletion          F9  Print message               :MESSAGE TEXT Screen Commands   B  Bounce                       *  Flag}
  1726. {F10 Undelete (remove delete mark)      F10 Take address into address book      :----------------------------}
  1727. {F11 Reply to message                   F11 Save message into an email folder  : G   Goto a specified folder     General Pine Commands }
  1728. {F12 Forward                            F12 Export message into a plain file    : H   Full Header Mode            --------------------- }
  1729. {                                                                       :Tab  Next New                    O  Show all other available commands }
  1730. {Available Commands -- Group 3                                          : W   Whereis -- search for a     ?  Show Help text      Q Quit Pine }
  1731. {------------------------------                                         :     specific word in message    M  MAIN MENU Screen    L FOLDER LIST screen}
  1732. {F7             Jump to message    F9  Full header mode      F11 Flag message   :                                   I  FOLDER INDEX Screen C  Compose a message }
  1733. {F8             Next New           F10 Bounce this message   F12 Pipe to a Unix command :}
  1734.  
  1735. NOTE: The presence or absence of the following commands is determined by
  1736. \"feature-list\" options in your Pine configuration.  Also, some of these
  1737. commands may be administratively disabled by your system manager; if they don't
  1738. work, please check with your local help desk before reporting a bug.
  1739.         o Header Mode (toggle between display of full or minimal headers)
  1740.         o Flag (mark message as important or set other message status flags)
  1741.         o Bounce (re-mail message)
  1742.         o Pipe message to a Unix command
  1743.         o Select this message (:) --part of the \"aggregate\" cmd set
  1744.  
  1745. The \"Pipe message to a Unix command\" command is not available in PC-Pine.
  1746.  
  1747. ------------------------------------------
  1748. | Description of the MESSAGE TEXT Screen |
  1749. ------------------------------------------
  1750.  
  1751. The upper right corner of the view message screen displays status
  1752. information about the currently open collection and folder and about the
  1753. current message.  It shows the name of the collection in angle brackets
  1754. and then the name of the folder.  The status line also displays the number
  1755. of messages in the folder, the number of the current message and the
  1756. percentage of the current message that has been displayed on the screen.
  1757. If the message is marked for deletion \"DEL\" will appear in the upper
  1758. right as well.
  1759.  
  1760. NOTE: to rapidly move to the end of a message, enter W (or ^W) followed
  1761. by ^V.  Similarly, W followed by ^Y will take you to the beginning of
  1762. the message.
  1763.  
  1764. ------------------------------
  1765. | Brief Command Explanations |
  1766. ------------------------------
  1767.  
  1768. REPLY AND FORWARD
  1769.  
  1770. Replying ({F11:R}) and Forwarding ({F12:F}) are your two alternatives for
  1771. following up on the message you are reading. You would use reply if you
  1772. want to get email back to the author of the message and/or the other
  1773. people who have already seen it.  You use forward if you want somebody new
  1774. to see the message.
  1775.  
  1776. In the normal case, the only thing that you must supply when forwarding a
  1777. message is the name/email address of the news recipient.  Pine will
  1778. include the text of the forwarded message.  Pine will also include any
  1779. attachments to the message if you have requested them.  There is space
  1780. above the forwarded text for you to include any comments.
  1781.  
  1782. When replying, you usually have to answer some questions.  If the message
  1783. is to multiple people and/or specified with a Reply-To: header, then you
  1784. will have to decide who should get the reply.  You also need to decide
  1785. whether or not to include the previous message in your reply.  Some of
  1786. this is configurable.  Specifically, see the include-header-in-reply and
  1787. include-text-in-reply configuration features.
  1788.  
  1789. Both the Reply and Forward commands react to the full header mode toggle.
  1790. If the full header mode is on, then all the header and delivery lines are
  1791. included with the text of the message in your reply/forward.
  1792.  
  1793. SAVE AND EXPORT
  1794.  
  1795. Export ({F12:E}) and Save ({F11:S}) are the two alternatives Pine gives
  1796. you to keep a copy of the message you are reading. If you want to keep the
  1797. message within Pine's email world, use \"save\"; if you want to use the
  1798. message in another program, use \"export\".
  1799.  
  1800. When you save a message, it is put into an existing folder or into a new
  1801. folder in one of your existing folder collections.  The message stays in
  1802. email format and can be read by Pine again.  Pine may use a special format
  1803. for its mail folders -- never edit a Pine folder by hand or with any
  1804. program other than Pine.  The exact behavior of the save command can be
  1805. configured with the save-will-quote-leading-froms, save-will-not-delete,
  1806. and save-will-advance feature list settings.
  1807.  
  1808. When you use export, the message is placed in a plain text file in your
  1809. home directory or current working directory, depending on the
  1810. use-current-dir configuration setting.  In the normal case, only minimal
  1811. headers are exported with the message; however, if the full header mode is
  1812. toggled on, then complete headers are exported along with the message
  1813. text.
  1814.  
  1815. VIEW ATTACH
  1816.  
  1817. The View/Save Attachment ({F4:V}) command allows you to handle MIME
  1818. attachments on a message you have received.  Pine shows you a list of the
  1819. message attachments--you just choose the attachment you want.  You may
  1820. either view or save the selected attachment.
  1821.  
  1822. Because many attachments require external programs for display, there is
  1823. some system configuration that has to happen before you can actually
  1824. display attachments.  Hopefully much of that will have been done already
  1825. by your system administrator.  MIME configuration is handled with the
  1826. \"mailcap\" configuration file.  (See the release notes for more information.)
  1827.  
  1828. WHEREIS
  1829.  
  1830. The WhereIs ({F8:W}) command does a \"find in current message\" operation.
  1831. You type in a word and Pine will try and find it in the message you are
  1832. reading.  You can also use WhereIs to jump to the beginning (Ctrl-Y) or
  1833. end (Ctrl-V) of the message.
  1834.  
  1835. NEXT NEW (TAB) COMMAND
  1836.  
  1837. When you press the TAB key, Pine advances to the next \"interesting\"
  1838. message.  When you are using Pine to read email, that message is the next
  1839. message in the folder which you have not read before or which you have
  1840. previously marked \"Important\" via the Flag command.  When reading news
  1841. folders, the next \"interesting\" message is the next one which you have
  1842. not yet deleted.
  1843.  
  1844. TAKE ADDRESS
  1845.  
  1846. With the Take Address command, you can extract email addresses from an
  1847. incoming message and save them in an address book.  This is an easy way
  1848. to add to your address book and avoid having to remember the email
  1849. addresses of the people who write to you.
  1850.  
  1851. If the message is just to you individually, then you will only need to
  1852. provide a nickname.  If the message is more complicated (with more than
  1853. one recipient or an email list involved), then you will see an address
  1854. selection screen which lets you choose the address you want to save into
  1855. your address book, or add several of them to a personal address list.
  1856.  
  1857. HEADER MODE
  1858.  
  1859. Every email message comes with some header lines that you normally don't
  1860. see.  These include anywhere from 3-20 lines added by the Internet mail
  1861. transport system to record the route your message took, for diagnostic
  1862. purposes.  These are normally of no import and simply add clutter, so Pine
  1863. suppresses them from MESSAGE TEXT display.  There is, however, a way to
  1864. reveal them.
  1865.  
  1866. The Header Mode ({F9:H}) command is a toggle which controls Pine's
  1867. handling of these header lines.  Normally, full headers is \"off\" and you
  1868. only see a few lines about who a message is to and who it is from.  When
  1869. you press {F9:\"H\"} to turn full headers on, Pine will show you the
  1870. normal header lines as well as delivery headers, comment headers and MIME
  1871. headers.
  1872.  
  1873. Several different Pine commands honor the header mode -- it affects how
  1874. messages are displayed, how they appear in forward and reply email, how
  1875. they are printed, they are saved, and how they are exported. In Unix
  1876. Pine, the Pipe command is also affected.
  1877.  
  1878. The presence or absence of the Header Mode command is determined by the
  1879. \"enable-full-header-cmd\" feature-list option in your Pine
  1880. configuration.
  1881.  
  1882. FLAG
  1883.  
  1884. Flag ({F11:*}) is the command which allows users to manipulate the status
  1885. flags which appear on the left side of the FOLDER INDEX screen.  The most
  1886. common use of this is to mark a message as important. This is something of
  1887. a note to yourself to get back to that message.  You can also use the flag
  1888. command to set (or unset) the flags which indicate that a message is new,
  1889. read or answered.
  1890.  
  1891. The availability of the flag command is determined by the
  1892. \"enable-flag-cmd\" feature-list option in your Pine configuration. Also,
  1893. Flag may be administratively disabled by your system manager; if it
  1894. doesn't work, please check with your local help desk before reporting a
  1895. bug.
  1896.  
  1897. ALTERNATE CHARACTER SETS
  1898.  
  1899. Pine attempts to stay out of the way so that it won't prevent you from
  1900. viewing mail in any character set.  It will simply send the message to
  1901. your display device.  If the device is capable of displaying the message
  1902. as it was written it will do so.  If not, the display may be partially or
  1903. totally incorrect.  If the message is marked as being in a character set
  1904. other than \"US-ASCII\" and it is a character set that is different from
  1905. the set you have indicated with the \"character-set\" variable in your
  1906. configuration, then a warning message will be printed to your screen at
  1907. the beginning of the message display.
  1908.  
  1909. In all cases Pine requires that the display device can handle the
  1910. character set.  For example, most X-terminals will display the ISO-8859-1
  1911. character set if the right font is selected.  VT220's and higher also
  1912. display ISO-8859-1.  Displays for other characters sets are less common.
  1913.  
  1914. <End of help on this topic>
  1915. ===== h_folder_maint =====
  1916.                         FOLDER LIST COMMANDS
  1917. {Available Commands -- Group 1        Available Commands -- Group 2     :Navigating the Folder Screen            Operations on the Selected Folder}
  1918. {-------------------------------      ------------------------------    :----------------------------            ---------------------------------}
  1919. {F1  Show Help Text                    F1  Show Help Text               : P   Move to previous folder              V  View Index of selected folder}
  1920. {F2  Toggle to see more commands       F2  Toggle to see more commands  : N   Move to next folder                  D  Delete}
  1921. {F3  MAIN MENU Screen                  F3  Quit Pine                    : -   Show previous page of listing        R  Rename}
  1922. {F4  Select folder and view it         F4  Compose a message            :Spc  Show next page of listing}
  1923. {F5  Move to previous folder                    :}
  1924. {F6  Move to next folder               F6  Specify a folder to go to    :FOLDER LIST Screen Commands              General Pine Commands}
  1925. {F7  Show previous screen of listing   F7  Show FOLDER INDEX of current folder :---------------------------              ---------------------}
  1926. {F8  Show next screen of listing       F8  Whereis (search folder names): A  Add a folder                          O  Show all other available commands}
  1927. {F9  Delete selected folder            F9  Print folder listing         : G  Specify a folder to go to             ?  Show Help text
  1928. {F10 Add a new folder                                                   : I  Show FOLDER INDEX of current folder   M  MAIN MENU Screen}
  1929. {F11 Rename selected folder                                             : W  Whereis (search folder names)         Q  Quit Pine}
  1930. {                                                                       : Y  Print folder listing                  C  Compose a message}
  1931.  
  1932. -----------------------------------------
  1933. | Description of the FOLDER LIST Screen |
  1934. -----------------------------------------
  1935.  
  1936. The purpose of the FOLDER LIST screen is to display your message folders
  1937. and allow you to \"open\" or view a new one, or manage your folders using the
  1938. Rename, Delete, and Add commands.  The status bar shows information about
  1939. the current folder.
  1940.  
  1941. The appearance of the Folder List depends upon your Pine configuration.
  1942. The most basic configuration will show a single list of folders, beginning
  1943. with the three distinguished folders INBOX, sent-mail, and saved-messages.
  1944. All other folders will be listed in alphabetical order.
  1945.  
  1946. If you or your system administrator have defined additional collections,
  1947. e.g. News, then you may see each of your collections listed with a
  1948. \"Select Here to See Expanded List\" button.  Alternatively, Pine can be
  1949. configured to always immediately display the complete list of folders in
  1950. each collection via the \"expanded-view-of-folders\" feature list option.
  1951.  
  1952. -----------------
  1953. | About Folders |
  1954. -----------------
  1955.  
  1956. What are Folders?
  1957.  
  1958. Folders are simply files where messages are kept.  Every message has to be
  1959. in a folder.  Most every Pine user starts out with 3 folders: an INBOX, a
  1960. folder for sent mail and a folder for saved messages.
  1961.  
  1962. You may create as many other folders as you wish.  They must be given
  1963. names that can be filenames on the filesystem.  On DOS that means they
  1964. must be 8-characters or less; on Unix you shouldn't use special characters
  1965. such as \"/\".  Normally PC-Pine folders are automatically given the DOS
  1966. extension \".MTX\" (which stands for Mailbox-text).  The extension is
  1967. suppressed from FOLDER LIST displays, and should not be entered when
  1968. typing a folder name at a Save or Goto prompt.  The use of the MTX extension
  1969. can be overridden by a Setup/Config option, which may be useful when
  1970. accessing saved-message folders on a Unix host via SMB or NFS.  PC-Pine
  1971. can understand the normal Unix mail folder format, but can only open
  1972. those folders READ-ONLY.
  1973.  
  1974. You can move messages from one folder to another by opening the original
  1975. folder and saving messages into the other folder just as you can save
  1976. message from your INBOX to any other folder.
  1977.  
  1978. Folders are just files in the filesystem.  However, the files which are
  1979. folders have some special formatting in them (so that Pine knows where one
  1980. message ends and another begins) and should *not* be edited outside of
  1981. Pine.  If you want copies of your messages in text files that you can edit
  1982. or otherwise manipulate, use the export command to export them from Pine.
  1983.  
  1984. ----------------------
  1985. | Folder Collections |
  1986. ----------------------
  1987.  
  1988. Those of you with simple mail configurations will just see a list of all the
  1989. folders you have.  The special folders for INBOX, sent mail and saved messages
  1990. will appear at the top of the list.  All others are in alphabetical order.
  1991.  
  1992. That model wouldn't work for Pine users with multiple collections.  If you
  1993. or your system administrator have defined more than one collection or if
  1994. you have a collection (news or otherwise) defined on your system, then you
  1995. will see each of your collections listed with a \"Select Here to See
  1996. Expanded List\" button.  Pine can be configured to always show you all
  1997. folders in all collections with the \"expanded-view-of-folders\" feature
  1998. list option in your Pine configuration.
  1999.  
  2000. Why have Collections?
  2001.  
  2002. If a Pine user only got 5 messages a day and used the same computer all the
  2003. time, then folders would be enough.  For good or bad, that is not the
  2004. case.  People who use more than one computer account need to have
  2005. different sets of folders on those different platforms.  People who have
  2006. hundreds or thousands of folders need a way to group folders together.
  2007. That is where collections come in.
  2008.  
  2009. Types of Collections.
  2010.  
  2011. A collection of folders is just a group of folders in the same directory
  2012. on the same machine.  In general, all collections of folders are equal in
  2013. Pine's eye.  However, there are some special collections:
  2014.  
  2015.         INCOMING FOLDERS:  Pine's \"incoming-folders\" configuration is a
  2016. special collection used to supplement your single INBOX.  All the folders
  2017. here are those that get incoming messages.  You may have multiple folders
  2018. like this because you use an external program to filter your email or
  2019. because you have multiple accounts.
  2020.  
  2021.         NEWS:  You can also define a collection specifically for
  2022. newsgroups.  Pine does this for you implicitly when you define a NNTP
  2023. Server in your Pine configuration.  The news collection is presented last
  2024. and Pine knows not to save messages there.
  2025.  
  2026.         DEFAULT COLLECTION FOR SAVES:  Perhaps the most important special
  2027. collection is the one which you specify as the first item of the
  2028. configuration for \"folder-collections\".  This is the default collection
  2029. for your saved and sent messages folders.
  2030.  
  2031. There is no limit to the number of collections you can have. Everyone
  2032. starts with just one collection and few people ever have more than a dozen
  2033. or so.
  2034.  
  2035. Defining Collections.
  2036.  
  2037. In the absence of any folder-collection definitions, Pine will assume a
  2038. single default folder collection, and if necessary, create the directory
  2039. \"mail\" in your Unix home directory to hold your folders.  Otherwise,
  2040. Pine will never create any directories.  However, you may create as many
  2041. mail directories as you would like using the Unix \"mkdir\" command, and
  2042. then define folder-collection entries to correspond with each one. This is
  2043. done via the Setup/Config command on the Main Menu.
  2044.  
  2045. ----------------------
  2046. | Valid Folder Names |
  2047. ----------------------
  2048.  
  2049. Once your folder collections are defined, you can usually refer to
  2050. folders by their simple (unqualified) name, or pick from a FOLDER LIST
  2051. display.  However, understanding the complete syntax for folder names,
  2052. both local and remote, is handy when using the Goto command and when
  2053. you are adding new folder collections via the SETUP CONFIGURATION screen.
  2054.  
  2055. Local folders follow the local naming rules.  For example,
  2056. \"~/mail/september-1994\" might be a reasonable folder name on Unix
  2057. and \"\\C:\\PINE\\FOLDERS\\OCT-94\" might exist on a PC.
  2058.  
  2059. Pine users have the option of using folders which are stored on some other
  2060. computer.  Pine accesses remote folders via IMAP (the Internet Message
  2061. Access Protocol), or in the case of news, via NNTP (the Network News
  2062. Transport Protocol).  To be able to access remote folders in Pine, the
  2063. remote host must be running the appropriate server software (imapd or
  2064. nntpd) and you must correctly specify the name of the folder to Pine,
  2065. including the domain name of the remote machine. For example,
  2066. \"{{:{}monet.art.nowhere.edu}INBOX\" is a remote folder specification, as
  2067. is \"{{:{}monet.art.nowhere.edu}~/mail/september-1994\".  As you can tell,
  2068. the name of the computer is in {{:{}} brackets followed immediately by the
  2069. name of the folder.  If, as in these examples, there is no remote access
  2070. protocol specified, then IMAP is assumed.
  2071.  
  2072. There are certain markings which have special meanings in folder names:
  2073.     o A \"*\" in front of the folder specification means that the folder is
  2074.       a bulletin board -- shared access and no write privileges.  Examples:
  2075.            *comp.mail.pine, *{{:{}wharhol.art.nowhere.edu}job-board
  2076.     o A folder name beginning with \"#mh/\" is an mh format folder.  Examples:
  2077.            #mh/mail/sep-1994, {{:{}rembrandt.art.nowhere.edu}#mh/mail/sep-1994
  2078.  
  2079. There are certain flags within remote folder names:
  2080.     o An \"/anonymous\" flag means anonymous IMAP access.  Example:
  2081.       {{:{}wharhol.art.nowhere.edu/anonymous}job-board
  2082.     o A \"/nntp\" flag means NNTP protocol access.  It cannot be used with
  2083.       the /anonymous flag.  Example:
  2084.            *{{:{}news.nowhere.edu/nntp}comp.mail.pine
  2085.  
  2086. Note that \"INBOX\" has special meaning in both local and remote folder
  2087. specifications.  The name INBOX refers to your \"principal incoming
  2088. message folder\" and will be mapped to the actual file name used for your
  2089. INBOX on any given host.  Therefore, a name like
  2090. \"{{:{}xxx.art.nowhere.edu}INBOX\" refers to whatever file is used to
  2091. store incoming mail for you on that particular host.
  2092.  
  2093. <End of help on this topic>
  2094. ===== h_folder_open =====
  2095.  
  2096. This screen is designed to allow you to quickly and easily survey your
  2097. folders and select one to open.
  2098.  
  2099. Navigating the List of Folders             General Pine Commands
  2100. ------------------------------             ---------------------
  2101. {F5 : P }  Move to previous folder          {F1 : ? }  Show this help text
  2102. {F6 : N }  Move to next folder
  2103. {F7 : - }  Show previous screen of folders
  2104. {F8 :Spc}  Show next screen of folders
  2105. {F12: W }  WhereIs (search folder names)
  2106.  
  2107. Folder Selection Commands
  2108. -------------------------
  2109. {F3 : E }  Exit the Folder Select menu (without selecting a folder)
  2110. {F4 : S }  Select the currently highlighted folder
  2111.  
  2112. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  2113. press \"?\" for Help... Look for the section \"About Folders\".
  2114.  
  2115. <End of help on this topic>
  2116. ===== h_folder_subscribe =====
  2117.  
  2118. This screen is designed to help you subscribe to newsgroups you are not
  2119. currently subscribed to.  The screen display is a list of all available
  2120. newsgroups (or possibly a partial list if you specified a partial name
  2121. when entering the screen).  Groups you have already subscribed to have the
  2122. letters \"SUB\" next to them.  You may select a single new group to
  2123. subscribe to by moving the cursor to that group and pressing \"S\"  or
  2124. carriage return.  Alternatively, you may change into ListMode with the
  2125. \"ListMode\" command.  The display will change slightly so that each group
  2126. has a checkbox in front of it.  Use the cursor and the Set/Unset command
  2127. to place an \"X\" in front of each newsgroup you wish to subscribe to. 
  2128.  
  2129. When you are finished marking groups, the \"Subscribe\" command will
  2130. subscribe you to those groups you have marked.  Note, you may not
  2131. unsubscribe to groups with this command.  Instead of the \"A\"
  2132. \"Subscribe\" command, use the \"D\" UnSbscrbe command. 
  2133.  
  2134. Navigating the List of Newsgroups          General Pine Commands
  2135. ---------------------------------          ---------------------
  2136. {F5 : P }  Move to previous group           {F1 : ? }  Show this help text
  2137. {F6 : N }  Move to next group
  2138. {F7 : - }  Show previous screen of groups
  2139. {F8 :Spc}  Show next screen of groups
  2140. {F12: W }  WhereIs (search group names)
  2141. {F9 : L }  Use ListMode
  2142.  
  2143. Group Selection Commands
  2144. -------------------------
  2145. {F3 : E }  Exit the News Subscribe menu (without selecting any groups)
  2146. {F4 : S }  Subscribe to the currently highlighted newsgroup
  2147.  
  2148. When in ListMode, there is an additional command for marking groups to
  2149. subscribe to:
  2150.  
  2151. ListMode Commands
  2152. -------------------------
  2153. {F9 : X }  Set or unset the highlighted group
  2154.  
  2155. <End of help on this topic>
  2156. ===== h_folder_postnews =====
  2157.  
  2158. This screen is designed to allow you to quickly and easily survey
  2159. the available newsgroups and select one to post news to.
  2160.  
  2161. Navigating the List of Newsgroups          General Pine Commands
  2162. ---------------------------------          ---------------------
  2163. {F5 : P }  Move to previous group           {F1 : ? }  Show this help text
  2164. {F6 : N }  Move to next group
  2165. {F7 : - }  Show previous screen of groups
  2166. {F8 :Spc}  Show next screen of groups
  2167. {F12: W }  WhereIs (search group names)
  2168.  
  2169. Group Selection Commands
  2170. -------------------------
  2171. {F3 : E }  Exit the Selection menu (without selecting a group)
  2172. {F4 : S }  Select the currently highlighted newsgroup
  2173.  
  2174. <End of help on this topic>
  2175. ===== h_folder_save =====
  2176.  
  2177. This screen is designed to allow you to quickly and easily survey your
  2178. folders and select one to use for saving the current message.
  2179.  
  2180. Navigating the List of Folders             General Pine Commands
  2181. ------------------------------             ---------------------
  2182. {F5 : P }  Move to previous folder          {F1 : ? }  Show this help text
  2183. {F6 : N }  Move to next folder
  2184. {F7 : - }  Show previous screen of folders
  2185. {F8 :Spc}  Show next screen of folders
  2186. {F12: W }  WhereIs (search folder names)
  2187.  
  2188. Folder Selection Commands
  2189. -------------------------
  2190. {F3 : E }  Exit the Folder Select menu (without selecting a folder)
  2191. {F4 : S }  Select the currently highlighted folder
  2192.  
  2193. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  2194. press \"?\" for Help... Look for the section \"About Folders\".
  2195.  
  2196. <End of help on this topic>
  2197. ===== h_folder_fcc =====
  2198.  
  2199. This screen is designed to allow you to quickly and easily survey your
  2200. folders and select one to use as the file carbon copy (fcc) for the
  2201. current message.
  2202.  
  2203. Navigating the List of Folders             General Pine Commands
  2204. ------------------------------             ---------------------
  2205. {F5 : P }  Move to previous folder          {F1 : ? }  Show this help text
  2206. {F6 : N }  Move to next folder
  2207. {F7 : - }  Show previous screen of folders
  2208. {F8 :Spc}  Show next screen of folders
  2209. {F12: W }  WhereIs (search folder names)
  2210.  
  2211. Folder Selection Commands
  2212. -------------------------
  2213. {F3 : E }  Exit the Folder Select menu (without selecting a folder)
  2214. {F4 : S }  Select the currently highlighted folder
  2215.  
  2216. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  2217. press \"?\" for Help... Look for the section \"About Folders\".
  2218.  
  2219. <End of help on this topic>
  2220. ===== h_address_book =====
  2221.                          ADDRESS BOOK COMMANDS
  2222. {Available  Commands -- Group 1         Available Commands -- Group 2   :Address Book Navigation        General Pine Commands}
  2223. {-------------------------------        ------------------------------  :-----------------------        ---------------------}
  2224. {F1  Show Help Text                      F1  Show Help Text             : P  Prev Address                  ?  Display this help text}
  2225. {F2  Toggle to see more commands         F2  Toggle to see more commands: N  Next Address                  O  Show all other available commands}
  2226. {F3  Exit this screen                    F3  Quit Pine                  : -  Previous page of address book E  Exit this screen}
  2227. {F4  View/Edit selected entry                                           :Spc Next page of address book     Q  Quit Pine}
  2228. {F5  Move to previous entry              F5  FOLDER LIST screen         : W  WhereIs (search for word/     C  Compose message to selected addr}
  2229. {F6  Move to next entry                  F6  Specify a folder to go to  :      or  name in address book)   L  FOLDER LIST screen}
  2230. {F7  Previous page of address book       F7  FOLDER INDEX screen        :                                  G  Specify a folder to go to}
  2231. {F8  Next page of address book                                          :Address Book Commands             I  FOLDER INDEX screen}
  2232. {F9  Delete selected entry               F9  Print address book         :------------------------------------------------}
  2233. {F10 Add new entry to address book       F10 TakeAddr to another abook  : V  View/Edit selected entry      D  Delete selected entry}
  2234. {F11 Compose to selected entry           F11 Export entry to a file     : Y  Print address book            T  TakeAddr to another address book}
  2235. {F12 Whereis (search address book)       F12 Forward entry by mail      : X  Export entry to a file        A  Add new entry to address book}
  2236. {: F  Forward entry by mail}
  2237.  
  2238. ------------------------------------------
  2239. | Description of the Address Book Screen |
  2240. ------------------------------------------
  2241.  
  2242. This screen lets you edit any and all entries in your address book.  It
  2243. also acts as a short-cut for composing messages to people in the address
  2244. book.  When, from this screen, you press {F11:\"C\"} for ComposeTo, the
  2245. message starts \"pre-addressed\" to whatever address book entry is
  2246. currently selected.
  2247.  
  2248. If you have more than one address book defined for yourself or if your
  2249. system has a site-wide address book defined, you may see a list of address
  2250. books and a \"Select Here to See Expanded List\" button for each of them.
  2251. Alternatively, Pine can be configured to immediately display all the
  2252. entries in each address book via the \"expanded-view-of-addressbooks\"
  2253. feature list option in your Pine configuration.
  2254.  
  2255. Pine's address book helps you keep a list of addresses you send mail to so
  2256. you do not have to remember addresses that are often complex.  Each entry
  2257. in the address book has five fields, all of them optional.  The three
  2258. elements which are usually visible on the ADDRESS BOOK display, are:
  2259.  
  2260.         NICKNAME: A short easy-to-remember label to identify the entry.
  2261.         This is what you type in as you are addressing the message in the
  2262.         composer.  If there is a matching entry in your address book(s),
  2263.         Pine will extract the corresponding FullName and Address fields to
  2264.         generate the actual address for your message.
  2265.  
  2266.         FULLNAME: A longer field where you can put the full name of the
  2267.         person or organization.  Usually the full names are put in last
  2268.         name first so they sort nicely in alphabetical order.  Whatever
  2269.         you put as the name here will appear on the message when it is
  2270.         finally delivered.
  2271.  
  2272.         ADDRESS: This is the actual email address itself.  This must be
  2273.         a valid Internet address that conforms to the Internet message
  2274.         header standard, RFC-822.  (There is more information on email
  2275.         addresses a little later in this section.)
  2276.  
  2277. The two fields which aren't usually visible are:
  2278.  
  2279.         FCC: The name of the folder you would like a copy of any outgoing
  2280.         message to this address to be saved in.  If this field is set, and
  2281.         this address is the first one in the message's To: header, then
  2282.         Pine will use this folder name for the FCC in lieu of the normal
  2283.         FCC folder name.
  2284.  
  2285.         COMMENTS: This field contains arbitrary text for your convenience.
  2286.  
  2287. Due to screen width limitations, these last two fields do not show up in
  2288. the normal ADDRESS BOOK display.  You may select the \"View/Edit\" command to
  2289. view or modify them.  You may use the configuration variable
  2290. \"addressbook-formats\" to add these fields to your ADDRESS BOOK display,
  2291. or to modify the format of the display.
  2292.  
  2293. ---------------------------
  2294. | Sorting the Address book |
  2295. ---------------------------
  2296.  
  2297. By default, address book entries are sorted alphabetically on the full
  2298. name with distribution lists sorted to the end.  Sorting can be changed by
  2299. resetting the address book sort rule in the Pine SETUP CONFIGURATION screen
  2300. --assuming you have \"write\" permission for the address book file.
  2301.  
  2302. Unlike the sorting of folders (which only changes presentation), sorting an
  2303. address book actually changes the file as it is kept on the computer.  For
  2304. this reason you may not be able to sort a shared or system-wide address
  2305. book.
  2306.  
  2307. ----------------------
  2308. | Distribution Lists |
  2309. ----------------------
  2310.  
  2311. Pine entries can be simple cases of aliases (a single nickname is linked
  2312. to a single email address) or distribution lists (a single nickname
  2313. pointing at more than one email address).  Each distribution list has a
  2314. nickname, a full name and a list of addresses.  The addresses may be
  2315. actual addresses or they may be other nicknames in your address book.
  2316. They may even refer to other distribution lists.  The command to create a
  2317. new distribution list is {F10:\"A\"}.  To add entries to an existing list
  2318. use the View/Edit ({F4:\"V\"}) command.  Delete ({F11:\"D\"}) will delete
  2319. a single address from the list if the cursor is placed on the address;
  2320. it will delete the entire distribution list if the cursor is on the
  2321. nickname/fullname line.  View/Edit may also be used to delete addresses
  2322. from a list.
  2323.  
  2324. Address field entries in distribution lists may take any one of three
  2325. forms: a nickname existing in any of the defined address books, a normal
  2326. address of the form \"jsmith@art.nowhere.edu\", or a complete
  2327. fullname/address combination, e.g. \"John Smith
  2328. <jsmith@art.nowhere.edu>\".
  2329.  
  2330. Distribution lists in Pine address books can only be used by the person or
  2331. people who have access to that address book.  They are not usually used to
  2332. implement discussion groups, but can be used to facilitate small
  2333. discussion groups if all the participants have access to the same shared
  2334. address book.
  2335.  
  2336. --------------------
  2337. | FCC and Comments |
  2338. --------------------
  2339.  
  2340. As mentioned above, each entry in the address book also has two other optional
  2341. fields, fcc and comments.  The command to look at or edit either of these
  2342. is the same View/Edit command used for all of the fields ({F4:\"V\"}).  The
  2343. comments field is just for your own use.  The fcc field overrides the
  2344. default fcc if this address is the first one on the To line.  The WhereIs
  2345. command may be used to search for particular strings in the address book,
  2346. including fields which are not visible (like comment and fcc by default).
  2347.  
  2348. -------------------------------------------------
  2349. | Exporting and Forwarding Address book entries |
  2350. -------------------------------------------------
  2351.  
  2352. When you use the Export ({F11:\"X\"}) command, the currently highlighted
  2353. address book entry is placed in a plain text file in your home directory
  2354. or current working directory, depending on the use-current-dir
  2355. configuration setting.
  2356.  
  2357. When you use the Forward ({F12:\"F\"}) command, the currently highlighted
  2358. address book entry is placed in a special attachment (which is only
  2359. understood by Pine) and you are put into the composer.  You can fill in
  2360. some comments in the body of the message, if you'd like, and send it to
  2361. somebody else who uses Pine.  The recipient may use the TakeAddr command
  2362. on that message to insert the address book entry you sent in their own
  2363. address book.
  2364.  
  2365. -------------------------------------------
  2366. | Multiple and/or Site-Wide Address books |
  2367. -------------------------------------------
  2368.  
  2369. You may have more than one personal address book.  In addition, there may
  2370. be one or more global address books.  This capability allows you to have
  2371. multiple personal address books (some of which may be shared) and it also
  2372. allows system administrators to implement site-wide address books that
  2373. contain entries for users on multiple machines within the organization.
  2374.  
  2375. Searching.  If you enter a nickname when composing a message, your
  2376. personal address books will be searched through in order, and then the
  2377. global address book(s) searched. If more than one address book has an entry
  2378. for the nickname, Pine uses the first one that it finds, so an entry in
  2379. your personal address book would override a global address book entry. If
  2380. after searching all the address books there is still no match, (Unix) Pine
  2381. then searches the local host password file on the assumption that you have
  2382. entered a local user name rather than an address book nickname.
  2383.  
  2384. Defining.  You define multiple personal address books via the
  2385. \"address-book\" option in the SETUP CONFIGURATION screen.  You can add as
  2386. many as you like. System administrators may specify a site-wide address
  2387. book by defining the \"global-address-book\" variable in the system-wide
  2388. Pine configuration file.  You may override this definition using the
  2389. \"global-address-book\" option in the SETUP CONFIGURATION screen.
  2390.  
  2391. Creating and updating.  Personal address books are normally created empty
  2392. and populated by explicit additions from within Pine, e.g. via the
  2393. TakeAddr command. Unlike personal address books, global address books may
  2394. not be modified/updated from within Pine; that is, they are Read-Only.
  2395. Thus, global address books are created, populated and updated outside of
  2396. Pine. They might be hand-edited, generated by a program from another
  2397. database, or by copying an existing address book.  See the Pine Technical
  2398. Notes document (included in the Pine distribution) for more information on
  2399. this.
  2400.  
  2401. Accessing.  Address books must be accessible via normal file access
  2402. routines on the machine where Pine is running.  That is, Pine does not yet
  2403. have the ability to access address books on remote systems, except via
  2404. low-level file access protocols such as NFS or SMB.  (It is understood
  2405. that this limits the utility of global address books for PC-Pine users.)
  2406.  
  2407. While global address books are explicitly intended to be shared, there is
  2408. nothing to prevent you from sharing a personal address book with other
  2409. Pine users. This might be useful in the case of a small workgroup.
  2410. However, it is recommended that updates to shared personal address books
  2411. be done when other Pine users are not accessing the address book. Pine
  2412. does not do any file-locking to manage concurrent updates to the
  2413. addressbook, but it does check to see if the file has been modified before
  2414. making any changes.  Consequently, inadvertent concurrent updates will
  2415. only cause other Pine users to have to restart their address book
  2416. operation, which will cause Pine to re-open the updated file.
  2417.  
  2418. -------------------------
  2419. | Valid Email Addresses |
  2420. -------------------------
  2421.  
  2422. When you enter an email address into the address field of your address
  2423. book you are giving Pine an address that it must be able to actually
  2424. reach.  The address you enter here must be a valid address which is
  2425. reachable from your site.  If it is not, you will get an error message
  2426. after sending the message.
  2427.  
  2428. A valid email address on the Internet has a user name, an \"@\" sign and
  2429. then a domain.  For example, jsmith@art.nowhere.edu is the email address
  2430. of a person with the username \"jsmith\" who has an account with
  2431. \"art.nowhere.edu\".  The number of segments on the right of the \"@\"
  2432. sign can vary depending on how the address is structured for the
  2433. particular host.
  2434.  
  2435. If you are sending to someone on the same system as you are, you can leave
  2436. the \"@\" and all the information to its right off of the address, and
  2437. Pine will fill it in automatically.  Sometimes you can also abbreviate the
  2438. right part of the address if you are at the same domain.  When sending
  2439. messages across gateways to other networks, the addresses get more
  2440. complicated.  Ask your local consultants for the correct syntax from your
  2441. site to the network you are trying to reach.
  2442.  
  2443. <End of help on this topic>
  2444. ===== h_select_addr =====
  2445.                    SELECT ADDRESS
  2446.  
  2447. Navigating the List of Messages               General Pine Commands
  2448. -------------------------------               ---------------------
  2449. {F5 : P }  Move to previous entry             {F1 : ? }  Show this help text
  2450. {F6 : N }  Move to next entry
  2451. {F7 : - }  Show previous screen of address book
  2452. {F8 :Spc}  Show next screen of address book
  2453. {F12: W }  WhereIs (search through address book)
  2454.  
  2455. Address Selection Commands
  2456. --------------------------
  2457. {F3 : E }  Exit the Address Select screen (without selecting an address)
  2458. {F4 : S }  Select the currently highlighted entry
  2459.  
  2460. This screen is designed to let you easily scan your address book(s) in
  2461. order to select an entry for the message you are composing.  You cannot
  2462. edit your address book in any way at this time, for address book
  2463. maintenance, select the address book command when not composing a message.
  2464.  
  2465. If you are composing a message and know the nickname of the person/list you
  2466. want, you can bypass this screen by simply typing in the nickname on the
  2467. appropriate header line (To:, Cc:, etc.)  Exiting this screen without
  2468. selecting an entry does not cancel your message.
  2469.  
  2470. FOR MORE INFORMATION on addresses and Pine's address book: From the Main
  2471. Menu, select \"A ADDRESS BOOK\" and press \"?\" for Help...
  2472.  
  2473. <End of help on this topic>
  2474. ===== h_use_address_bookl =====
  2475.                    COMPOSER: SELECT ADDRESSES
  2476.  
  2477. Navigating the List of Messages               General Pine Commands
  2478. -------------------------------               ---------------------
  2479. {F5 : P }  Move to previous entry             {F1 : ? }  Show this help text
  2480. {F6 : N }  Move to next entry
  2481. {F7 : - }  Show previous screen of address book
  2482. {F8 :Spc}  Show next screen of address book
  2483. {F12: W }  WhereIs (search through address book)
  2484.  
  2485. Address Selection Commands
  2486. --------------------------
  2487. {F3 : E }  Exit the Address Select screen (without selecting an address)
  2488. {F4 : S }  Select the currently highlighted entry
  2489. {F9 : L }  Change to ListMode
  2490.  
  2491. This screen is designed to let you easily scan your address book(s) in
  2492. order to select entries for the message you are composing.  You cannot
  2493. edit your address book in any way at this time, for address book
  2494. maintenance, select the address book command when not composing a message.
  2495.  
  2496. If you are composing a message and know the nickname of the person/list you
  2497. want, you can bypass this screen by simply typing in the nickname on the
  2498. appropriate header line (To:, Cc:, etc.)  Exiting this screen without
  2499. selecting an entry does not cancel your message.
  2500.  
  2501. The ListMode command will add a column at the left edge of the screen.
  2502. You mark the entries which you wish to select with the \"X\" command.
  2503. This allows you to choose more than one entry at a time.
  2504.  
  2505. FOR MORE INFORMATION on addresses and Pine's address book: From the Main
  2506. Menu, select \"A ADDRESS BOOK\" and press \"?\" for Help...
  2507.  
  2508. <End of help on this topic>
  2509. ===== h_use_address_bookx =====
  2510.                    COMPOSER: SELECT ADDRESSES
  2511.  
  2512. Navigating the List of Messages               General Pine Commands
  2513. -------------------------------               ---------------------
  2514. {F5 : P }  Move to previous entry             {F1 : ? }  Show this help text
  2515. {F6 : N }  Move to next entry
  2516. {F7 : - }  Show previous screen of address book
  2517. {F8 :Spc}  Show next screen of address book
  2518. {F12: W }  WhereIs (search through address book)
  2519.  
  2520. Address Selection Commands
  2521. --------------------------
  2522. {F3 : E }  Exit the Address Select screen (without selecting an address)
  2523. {F4 : S }  Select the currently highlighted entry
  2524. {F9 : X }  Set or Unset the highlighted entry
  2525.  
  2526. Mark the entries you wish to select with the \"X Set/Unset\" command.
  2527. Type \"S Select\" to select all of the entries you have marked, just as
  2528. if you had typed them in by hand.
  2529.  
  2530. FOR MORE INFORMATION on addresses and Pine's address book: From the Main
  2531. Menu, select \"A ADDRESS BOOK\" and press \"?\" for Help...
  2532.  
  2533. <End of help on this topic>
  2534. ===== h_select_nickname_take =====
  2535.                 TAKEADDR: SELECT NICKNAME
  2536.  
  2537. Navigating the List of Messages               General Pine Commands
  2538. -------------------------------               ---------------------
  2539. {F5 : P }  Move to previous entry             {F1 : ? }  Show this help text
  2540. {F6 : N }  Move to next entry
  2541. {F7 : - }  Show previous screen of address book
  2542. {F8 :Spc}  Show next screen of address book
  2543. {F12: W }  WhereIs (search through address book)
  2544.  
  2545. Message Selection Commands
  2546. --------------------------
  2547. {F3 : E }  Exit the Nickname Select screen (without selecting an address)
  2548. {F4 : S }  Select the currently highlighted entry
  2549.  
  2550. This screen is designed to let you modify or add to an existing address
  2551. book entry.  You have already selected the name(s) and address(es) through
  2552. \"Take Address\".  This screen simply lets you scan your address books and
  2553. select the nickname to be changed/augmented.  If you want to add a new
  2554. entry, then you are in the wrong place-- press {F3:\"E\"} to exit.
  2555.  
  2556. FOR MORE INFORMATION on addresses and Pine's address book: From the Main
  2557. Menu, select \"A ADDRESS BOOK\" and press \"?\" for Help...
  2558.  
  2559. <End of help on this topic>
  2560. ===== h_select_nickname =====
  2561.                 SELECT NICKNAME
  2562.  
  2563. Navigating the List of Messages               General Pine Commands
  2564. -------------------------------               ---------------------
  2565. {F5 : P }  Move to previous entry             {F1 : ? }  Show this help text
  2566. {F6 : N }  Move to next entry
  2567. {F7 : - }  Show previous screen of address book
  2568. {F8 :Spc}  Show next screen of address book
  2569. {F12: W }  WhereIs (search through address book)
  2570.  
  2571. Message Selection Commands
  2572. --------------------------
  2573. {F3 : E }  Exit the Nickname Select screen (without selecting an address)
  2574. {F4 : S }  Select the currently highlighted entry
  2575.  
  2576. This screen is designed to let you look at the nicknames in your address
  2577. books before choosing a new one.
  2578.  
  2579. FOR MORE INFORMATION on addresses and Pine's address book: From the Main
  2580. Menu, select \"A ADDRESS BOOK\" and press \"?\" for Help...
  2581.  
  2582. <End of help on this topic>
  2583. ===== h_takeaddr_screen =====
  2584.                       TAKE ADDRESS COMMANDS
  2585.  
  2586. {Navigating the List of Addresses       Address Selection Commands        :Navigating the List of Addresses       Address Selection Commands}
  2587. {--------------------------------       --------------------------        :--------------------------------       --------------------------}
  2588. { F5  Move to previous entry    F3  Exit without taking address : P  Move to previous entry              E  Exit without taking address}
  2589. { F6  Move to next entry        F4  Take current address(es)    : N  Move to next entry                  T  Take address}
  2590. { F7  Show previous page of address list                        : -  Show previous page of address list}
  2591. { F8  Show next page of address list                            :Spc Show next page of address list}
  2592. { F2  WhereIs (search list)                                     : W  WhereIs (search list)              List Mode}
  2593. {                               --------------                  :                                       ---------}
  2594. {Mode Toggle            F9  Set/Unset current address           :Single Mode                             X  Set/Unset current address}
  2595. {-----------            F10 Set all                             :-----------                             A  Set all addresses}
  2596. { F12 Toggle between List and single mode       F11 Unset all   : L  Switch to list mode                 U  Unset all addresses}
  2597. {                                                               :                                        S  Switch to single mode}
  2598.  
  2599. ------------------------------------------
  2600. | Description of the Take Address Screen |
  2601. ------------------------------------------
  2602.  
  2603. This screen is designed to let you select one or more address/name
  2604. combinations from the current message into your address book.  The cursor
  2605. is initially placed on the line with the message author.  Other lines
  2606. include the names of people and/or mailing lists who also received the
  2607. message.  Other people \"involved\" in the message (e.g. the person named as
  2608. Reply-To:) are also listed here.
  2609.  
  2610. The simple case is adding a new, single entry into your address book. To
  2611. do this, simply highlight the correct line and press {F4:\"T\"}.  To
  2612. create a new list or add to an existing list, switch the screen display
  2613. into List Mode by pressing {F12:\"L\"}.  In List Mode, you select the
  2614. group of addresses you wish to manipulate by marking them with an \"X\".
  2615. The Set/Unset ({F9:\"X\"}) command will turn the \"X\" on for the
  2616. highlighted address if it was off or turn it off if it was previously on.
  2617. The SetAll command will select all of the addresses, and the UnSetAll
  2618. command will turn off all the selections.  Once you've gotten the
  2619. selection the way you want it, you may create a new list by pressing
  2620. {F4:\"T\"}.
  2621.  
  2622. In both the simple and list cases, after choosing to take the address,
  2623. you will be asked for the nickname of the entry.  Typing in a new name
  2624. creates the new entry/list.  Entering an existing nickname will replace
  2625. the entry (simple case) or add to the list (list case).  Alternatively,
  2626. you can press Ctrl-T at the nickname prompt and select an existing
  2627. nickname from your address book.
  2628.  
  2629. You will normally start in Single Mode, unless you used the Apply command
  2630. to startup the TakeAddr screen, in which case you will start in List Mode.
  2631. You may switch between the two modes at any time.  If you've already
  2632. selected several addresses in List Mode, those will be remembered when you
  2633. switch to Single Mode and then back to List Mode.  The set of addresses
  2634. that are pre-selected when you start in List Mode are the From addresses
  2635. of all of the messages you are operating on.  You may, of course, easily
  2636. erase those selections with the UnSetAll command.
  2637.  
  2638. If you have more than one writable address book, you will be prompted for
  2639. the name of the address book you wish to add the new entry to before
  2640. anything else. You can use ^N and ^P to choose among the defined address
  2641. books, or type in the address book name.
  2642.  
  2643. FOR MORE INFORMATION on addresses and Pine's address book: From the Main
  2644. Menu, select \"A ADDRESS BOOK\" and press \"?\" for Help...
  2645.  
  2646. <End of help on this topic>
  2647. ===== h_attachment_screen =====
  2648.  
  2649. {F1 : ? }  Show this help text
  2650. {F3 : E }  Exit this screen without displaying or saving any attachments
  2651. {F4 : V }  View the currently selected attachment
  2652. {F5 : P }  Move to previous attachment
  2653. {F6 : N }  Move to next attachment
  2654. {F7 : - }  Previous page of the listed attachments
  2655. {F8 :Spc}  Next page of the listed attachments
  2656. {F9 : S }  Save the selected attachment to a file
  2657. {F10: | }  Pipe the selected attachment through a UNIX command (if enabled)
  2658. {F12: W }  Find the matching string in the attachment list
  2659.  
  2660. The Attachment Index displays a list of the current message's attachments,
  2661. and provides for the viewing, saving, or piping (if enabled) of each
  2662. attachment.  The first attachment is usually the message text, but does
  2663. not include the header portion of the message.
  2664.  
  2665. All attachments can be saved or piped into a UNIX command, but some may
  2666. not be readily displayed by either pine or an external tool.  In such
  2667. cases, the reason why the message cannot be displayed is displayed on
  2668. pine's message line.
  2669.  
  2670. <End of help on this topic>
  2671.  
  2672. ============= h_mail_text_att_view   ========================
  2673.  
  2674. This function allows you to view the contents of a text attachment. You
  2675. can only view one attachment at a time.
  2676.  
  2677.  _{F1:? }  Get Help     Display this help text
  2678.  _{F3:E }  Exit Viewer  Go back to mail viewing.
  2679.  _{F7:- }  Prev Page    Show the previous page of the current attachment.
  2680. { F8:Spc}  Next Page    Show the next page of the current attachment by pressing
  2681.  ______                 the space bar.
  2682.  _{F9:Y }  Print        Print the current attachment on paper.  You can select the
  2683.  ______                 printer or the print command via the \"Setup\" command
  2684.  ______                 on the Main menu.
  2685. {F11:S }   Save         Copy the current attachment to a file.  If you just enter
  2686.  ______                 a filename, the attachment will be saved with that name in
  2687.  ______                 your home/current directory.  You may enter the full
  2688.  ______                 path and filename to save it in another directory.
  2689. {F12: W }  WhereIs      Search the attachment for a string of letters.  If it is
  2690. ______                  found, move to it.  The string can be one word or a phrase.
  2691.  ______ If there are multiple occurrences, the cursor moves to the
  2692. ______                first occurrence beyond the current cursor position.
  2693.  
  2694. <End of help on this topic>
  2695. ======= h_pine_for_windows ========
  2696.                      GETTING HELP IN PINE
  2697.  
  2698. Pine offers specific help for every screen via the \"?\" or \"^G\"
  2699. keys.  (The Control-G key is used in contexts where \"?\" would be
  2700. mistaken as text being entered.)
  2701.  
  2702. The MAIN MENU help (\"?\") provides a general overview of Pine, as
  2703. well as information specific to that screen.  There is also a
  2704. \"Release Notes\" command available from the MAIN MENU.
  2705.  
  2706. Although this version of Pine is for Microsoft Windows, it is not a
  2707. full \"Graphical User Interface\" application.  However, it does
  2708. offer limited mouse support.  You can click on commands at the bottom
  2709. of the screen, and you can click or double-click on items on most
  2710. screens to select or view them.
  2711.  
  2712. In the mail index, clicking with the right mouse button on an item
  2713. will display that item in a separate window.  Control-Click will
  2714. always display the item in a new separate window.
  2715.  
  2716. In the composer message body you can select text with the mouse.
  2717. Press the mouse button down, drag across the text you want to select,
  2718. lift the mouse button.  If you move the mouse above the top or below
  2719. the bottom of the window the message text will scroll.  Shift-Click
  2720. will extend an existing selection.  You can Cut or Copy the selected
  2721. text in the composer message body.
  2722.  
  2723. In all other screens you can select any text visible on the screen
  2724. with the mouse, but can only Copy the selected text.
  2725.  
  2726. <End of help on this topic>
  2727. ===== h_composer =====
  2728.                        COMPOSER COMMANDS
  2729.  
  2730. CURSOR MOTION KEYS                     |EDITING KEYS
  2731.   ^B (Left Arrow)   Back character     | ^D       Delete current character
  2732.   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
  2733.   ^P (Up Arrow)     Previous line      | ^^       Set a mark
  2734.   ^N (Down Arrow)   Next line          | {F9:^K}       Cut marked text or
  2735.   ^A                Beginning of line  |           delete current line
  2736.   ^E                End of line        | {F10:^U }       Paste text, undelete lines
  2737.   {F7:^Y}                Previous page      |           cut with ^K, or unjustify
  2738.   {F8:^V}                Next page          |-------------------------------------
  2739.   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
  2740. ---------------------------------------| {F6(^W):^W    }   Whereis (search for string)
  2741. MESSAGE COMMANDS | GENERAL COMMANDS    | {F12:^T }      Spell checker
  2742.  {F3:^C}   Cancel     |  {F1:^G}    Get help     | {F4:^J}       Justify paragraph
  2743.  {F11:^O }  Postpone   |  ^Z    Suspend      | ^L       Redraw Screen
  2744.  {F2:^X}   Send       |  {F6:^_}    Alt. editor  | {F5:^R}       Read in a file
  2745.  
  2746.  
  2747. NOTE: The presence or absence of the following commands is determined by
  2748. \"feature-list\" options in your Pine configuration.  Also, some of these
  2749. commands may be administratively disabled by your system manager; if they
  2750. don't work, please check with your local help desk before reporting a bug.
  2751.         o Suspend (suspends Pine and gives a system prompt)
  2752.         o Alternate editor (allows you to compose with your own editor)
  2753.  
  2754. HINT: To move rapidly to the bottom of a message you are composing,
  2755. enter ^W^V.  To go to the top, ^W^Y.  These can be used in conjunction
  2756. with the Mark and Cut commands to eliminate large amounts of unwanted
  2757. text in a Reply.
  2758.  
  2759. The \"Alternate Editor\" and \"Spell Check\" commands are not available in
  2760. PC-Pine.
  2761.  
  2762. Pine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-], Ctrl-\\, ESC
  2763.  
  2764. NOTE: by default, Pine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
  2765. and XON), as normal characters, even though Pine does not use them except
  2766. during attached-to-ansi printing. However, the modem, or communication
  2767. software you are using may be configured for \"software flow control\"
  2768. which means that XON/XOFF must be treated as special characters by the
  2769. operating system.  If you see messages such as \"^X not defined for this
  2770. screen\", then your system is probably using software flow control. In
  2771. this case you will need to set the \"preserve-start-stop-characters\"
  2772. feature.  If you *do* set this feature, be advised that if you
  2773. accidentally hit a Ctrl-S, Pine will mysteriously freeze up with no
  2774. warning.  In this case, try typing a Ctrl-Q and see if that puts things
  2775. right.
  2776.  
  2777. ---------------------------
  2778. | Description of Composer |
  2779. ---------------------------
  2780.  
  2781. Pine has a built-in editing program which allows you to compose messages
  2782. without having to leave Pine.  The editor is designed to be very simple to
  2783. use so that you can get started writing email right away.
  2784.  
  2785. Messages are usually just text, about 80 columns wide.  Using upper and
  2786. lower case is encouraged.  On some systems the size limit of the message
  2787. is about 100,000 characters, which is about 2,000 lines.  You can include
  2788. punctuation and special characters found on most keyboards, but you can't
  2789. include characters with diacritical marks and certain special symbols.
  2790.  
  2791. Text automatically wraps as you type past the end of a line so you do not
  2792. have to hit return.  Using the {F4:\"Ctrl-J\"} command, you can also
  2793. reformat text explicitly, perhaps after you have deleted some text.
  2794.  
  2795. You can include other text files with the {F5.:\"Ctrl-R\".} You will be
  2796. prompted for the file name of the file.
  2797.  
  2798. ------------------------------
  2799. | Brief Command Explanations |
  2800. ------------------------------
  2801.  
  2802. MARK, CUT, AND PASTE
  2803.  
  2804. You can define a \"block\" of text, which can subsequently be deleted or
  2805. copied as a unit, by setting a mark at the start of the block (Ctrl-^) and
  2806. then moving the cursor to the end of the desired text block.  You can then
  2807. \"cut\" the block out ({F9:Ctrl-K}), move the cursor, and \"paste\" it
  2808. ({F10:Ctrl-U}) in the new location.  Also, you can paste more than once,
  2809. allowing you to use this feature to copy a block of text.
  2810.  
  2811. If you press {F9:Ctrl-K} without having marked anything, Pine will delete
  2812. a single line.  If you delete a group of lines together, Pine keeps them
  2813. in the same buffer, so {F10:Ctrl-U} will restore them as a block.  About
  2814. terminology:  Mark is shown as \"^^\".  The first \"^\" means you should
  2815. hold down the \"Control\" key on your keyboard.  The second \"^\" means
  2816. \"type the character ^\".
  2817.  
  2818. JUSTIFY ({F4:Ctrl-J})
  2819.  
  2820. The justify command reformats the text in the paragraph the cursor is in.
  2821. Paragraphs are separated by one blank line or a line beginning with a space.
  2822. This is useful when you have been editing a paragraph and the lines become
  2823. uneven.  The text is left aligned or justified and the right is ragged.  If
  2824. the text is already justified as typed with auto-wrap, no justification will
  2825. be done.
  2826.  
  2827. When composing a reply containing included text, the justify command will
  2828. reformat text to the right of the reply-indent-string (\"> \" by default),
  2829. adding or removing indented lines as needed.  Paragraphs are separated by a
  2830. blank line, a line containing only the reply-indent-string, or a line
  2831. containing the indent string and one or more blank spaces.  Included text
  2832. that was previously indented (or \"quoted\") is not preserved.
  2833.  
  2834. READ FILE ({F5:Ctrl-R})
  2835.  
  2836. This will allow you to copy in text from an existing file. You will be
  2837. prompted for the name of a file to be inserted into the message.  The file
  2838. name is relative to your home directory or must be a full path name on
  2839. your system.  The file will be inserted where the cursor is located.  *The
  2840. file to be read must be on the same system as Pine.* If you use Pine on a
  2841. Unix machine but have files on a PC or MAC, the files must be transferred
  2842. to the system Pine is running on before they can be read.  Please ask your
  2843. local computer support people about the correct way to transfer a file to 
  2844. your Pine system.
  2845.  
  2846. WHEREIS ({F6:Ctrl-W})
  2847.  
  2848. WhereIs searches the message body part of your composition and moves the
  2849. cursor to the first occurrence of the match string appearing after the
  2850. location of the cursor.  The search will wrap to the beginning of the
  2851. message when it no longer finds matches in the remainder of the message.
  2852.  
  2853. To search for the same string a second time, press {F12:^W} to begin search
  2854. and then just press RETURN to accept the previous search string shown in
  2855. square brackets rather than entering a new search string.
  2856.  
  2857. WhereIs can \"search\" for the first line or last line of a message -- this
  2858. means that WhereIs is a jump-to-top and jump-to-bottom feature, too.
  2859.  
  2860. POSTPONE ({F11:Ctrl-O})
  2861.  
  2862. Temporarily stop working on the current message so you may read other
  2863. messages or compose another message.  When you want to resume a message
  2864. later, start to compose and answer \"yes\" to the \"Continue postponed
  2865. composition?\" question.  You may postpone as many messages as you like.
  2866.  
  2867. SPELL CHECK ({F12:Ctrl-T})
  2868.  
  2869. Pine can call an external spell checking program to look over the message
  2870. you are composing.  By default, Pine uses the simple Unix spell checker.
  2871. There are no suggested alternative spellings, but Pine will show you the
  2872. \"incorrect\" word and let you fix it or move on.  If a word is misspelled
  2873. more than once, then you will be prompted to confirm the correction of
  2874. each occurrence of it.  Lines beginning with \">\" ( included messages)
  2875. will not be checked.  There is no spell check feature with PC-Pine.
  2876.  
  2877. SEND ({F2:Ctrl-X})
  2878.  
  2879. Before sending a message, Pine will ask you to confirm that you want the
  2880. message to go out.  At that confirmation stage, Pine moves the composer
  2881. back to the top so that you can verify that the right people are getting
  2882. the message.  After confirmation, the message is sent and copied to the
  2883. FCC folder (if any).
  2884.  
  2885. <End of help on this topic>
  2886. ====== h_composer_browse =====
  2887.  
  2888. Use this to browse files, perhaps created by some other application.  The
  2889. file name given can be a file in your home directory, an absolute file
  2890. path name for your system, or a file path relative to your home directory.
  2891. No wild card characters may be used.  In Unix Pine, you may use \"~\" to
  2892. refer to your home directory or \"~user\" to refer to another's home
  2893. directory.  The file must reside on the system running Pine.
  2894.  
  2895. If the \"use-current-dir\" feature is set, names are relative to your
  2896. current directory at the time you started Pine, rather than to your
  2897. home directory.
  2898.  
  2899. <End of help on this topic>
  2900. ====== h_composer_ins =====
  2901.  
  2902. Use this function to insert a text file into your message. The file name
  2903. given can be a file in your home directory, an absolute file path name for
  2904. your system, or a file path relative to your home directory.  No wild card
  2905. characters may be used.  In Unix Pine, you may use \"~\" to refer to your
  2906. home directory or \"~user\" to refer to another's home directory.  The
  2907. file must reside on the system running Pine.
  2908.  
  2909. If the \"use-current-dir\" feature is set, names are relative to your
  2910. current directory at the time you started Pine, rather than to your
  2911. home directory.
  2912.  
  2913. <End of help on this topic>
  2914. ====== h_composer_search =====
  2915.  
  2916. Search the message for a word or part of a word.  When searching in the
  2917. composer, only the message part of your mail is searched, and the cursor
  2918. is put on the first occurrence appearing after the location of the cursor.
  2919. The search will wrap to the beginning of the message when it no longer
  2920. finds matches in the remainder of the message.
  2921.  
  2922. To search for the same string a second time, press {F12:Ctrl-W} to begin
  2923. search and then just press RETURN to accept the previous search string
  2924. shown in square brackets rather than entering a new search string.
  2925.  
  2926. <End of help on this topic>
  2927. ======= h_composer_to ====
  2928.  
  2929. Topics:
  2930.  o The \"To:\" field
  2931.  o Email Address Format
  2932.  o Message Header Commands
  2933.  
  2934. -------------------
  2935. | The \"To:\" field |
  2936. -------------------
  2937.  
  2938. The address you enter here must be a valid address which is reachable
  2939. from your site.  If it is not, you will get an error message after sending
  2940. the message.
  2941.  
  2942. ------------------------
  2943. | Email Address Format |
  2944. ------------------------
  2945.  
  2946. You may enter a full name and address, a local address that Pine will
  2947. complete for you, the nickname of someone in an address book, or a local
  2948. mail alias defined by your system administrator.  When you move the cursor
  2949. out of this field, the nicknames will be expanded to the addresses in your
  2950. address book, and the local names will be expanded to include the actual
  2951. user name.  You may enter as many addresses as you wish, but they must be
  2952. separated by commas.  You can move around this and other header fields
  2953. with the arrow keys and use many of the usual composer editing keys.
  2954.  
  2955. A valid email address on the Internet has a username, an \"@\" sign and
  2956. then a domain.  For example, jsmith@art.nowhere.edu is the email address
  2957. of a person with the username \"jsmith\" who has an account with
  2958. \"art.nowhere.edu\".  The number of segments on the right of the \"@\"
  2959. sign can vary depending on how the address is structured for the
  2960. particular host.
  2961.  
  2962. If you are sending to someone on the same system as you are, you can leave
  2963. the \"@\" and all the information to its right off of the address, and
  2964. Pine will fill it in automatically.  Sometimes you can also abbreviate the
  2965. right part of the address if you are at the same domain.  When sending
  2966. messages across gateways to other networks, the addresses get more
  2967. complicated.  Ask your local consultants for the correct syntax from your
  2968. site to the network you are trying to reach.
  2969.  
  2970.                         MESSAGE HEADER COMMANDS
  2971.  
  2972. CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
  2973. ^B (Left Arrow)    Back character       | ^D       Delete current character
  2974. ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
  2975. ^P (Up Arrow)      Previous line        |
  2976. ^N (Down Arrow)    Next line            | {F9:^K}       Cut marked text or
  2977. ^A                 Beginning of line    |            delete current line
  2978. ^E                 End of line          | {F10:^U }      Undelete line(s)
  2979. {F7:^Y}                 Previous page        |
  2980. {F8:^V}                 Next page            |-------------------------------------
  2981. ^@ (Ctrl-SPACE)    Next word            |SCREEN/COMPOSITION COMMANDS
  2982. ----------------------------------------|
  2983. MESSAGE COMMANDS  | GENERAL COMMANDS    | {F12:^T }    To Addressbook/Browser
  2984. {F3:^C}   Cancel       |  {F1:^G}    Get help     | {F4:^J}     Attach File
  2985. {F11:^O }  Postpone     |  ^Z    Suspend      | ^L     Redraw Screen
  2986. {F2:^X}   Send         |                     | {F5:^R}     Rich Headers
  2987.  
  2988. <End of help on this topic>
  2989. ======= h_composer_cc ====
  2990.  
  2991. The Cc: field is just like the To: field, except it is used for addressees
  2992. that you wish to send a carbon copy to.  That is, the message is not directly
  2993. addressed to these recipients, but you wanted them to see the message.  The
  2994. only difference the recipients see is that their name is in the Cc: field,
  2995. rather than the To: field.
  2996.  
  2997. For information on email address formats or help with message header editing
  2998. commands, check the Help for the To: header.
  2999.  
  3000. <End of help on this topic>
  3001. ======= h_composer_bcc ====
  3002.  
  3003. The \"Bcc:\" (Blind carbon copy) header is used when you wish to send a 
  3004. copy of the message to one or more people whose addresses you do not
  3005. wish disclosed, either to reduce clutter or for confidentiality.
  3006.  
  3007. The format of the Bcc: field is just the same as the To: and Cc: fields in
  3008. the way the addresses are entered.  The recipients listed here will
  3009. receive a copy of the message, but --assuming your site's mail transport
  3010. software is properly configured-- their addresses will not show up in the
  3011. headers of the message, as delivered to all of the recipients.  The To:
  3012. and Cc:  recipients will not know a copy was sent to the Bcc: recipients.
  3013.  
  3014. Note: if there is no To: or Cc: or Lcc: address in the message, Pine
  3015. will automatically generate and place in the To: field a pseudo-address of 
  3016.   \"Undisclosed recipients: ;\"
  3017. or whatever string has been specified in the \"empty-header-message\"
  3018. variable.
  3019.  
  3020. The reason for this is to avoid embarrassment caused by some Internet
  3021. mail transfer software that interprets a \"missing\" To: header as 
  3022. an error and replaces it with an Apparently-to: header that may contain
  3023. the addresses you entered on the Bcc: line.  In addition, it may be
  3024. less disconcerting to Bcc: recipients to see *something* in the To: field.
  3025.  
  3026. You can manipulate what text ends up on the (originally) empty To:
  3027. field.  Just remember to put a colon and semicolon at the end of the
  3028. field, which is a special notation denoting that it is not a real address.
  3029.  
  3030. For information on email address formats or help with message header editing
  3031. commands, check the Help for the To: header.
  3032.  
  3033. <End of help on this topic>
  3034. ======= h_composer_lcc ====
  3035.  
  3036. The \"Lcc\" (List carbon copy) header is intended to be used when
  3037. you wish to send a message to a list of people but avoid having all
  3038. of their addresses visible, in order to reduce clutter when the
  3039. message is received.
  3040.  
  3041. It is similar to the \"Bcc\" (Blind carbon copy) header in that individual
  3042. addressees are hidden, but Lcc is designed to work specifically with
  3043. distribution lists you have created in your Pine address book.  Placing
  3044. the nickname of the list on the Lcc line will result in the full name of
  3045. your Pine Address Book list being placed on the To: line of the message,
  3046. using a special notation that distinguishes it from a real address. You
  3047. must leave the To: line blank for your list name to appear there.
  3048.  
  3049. For example, if you have this list entered in your Address Book:
  3050.  
  3051.         largo         Key Largo List       DISTRIBUTION LIST:
  3052.                                            bogie@mgm.com
  3053.                                            lauren@mgm.com
  3054.                                            walter@mgm.com
  3055.  
  3056. And you enter \"largo\" on the Lcc: line while composing a message, the
  3057. result is:
  3058.  
  3059.         To      : Key Largo List: ;
  3060.         Cc      :
  3061.         Bcc     :
  3062.         Fcc     : sent-mail
  3063.         Lcc     : Key Largo List <bogie@mgm.com>,
  3064.                   lauren@mgm.com,
  3065.                   walter@mgm.com
  3066.         Subject :
  3067.  
  3068. Each recipient listed on the Lcc: line receives a copy of the message
  3069. without their address being visible (as though they were listed on the
  3070. Bcc: line). The colon-semicolon notation used to put the full-name of the
  3071. list on the To: line is a special address format that doesn't specify any
  3072. actual addressees, but does give some information to the recipients of the
  3073. message.
  3074.  
  3075. Note: if after entering an LCC, you delete the list name that is placed
  3076. on the To: line, then recipients will see To: Undisclosed recipients: ;
  3077. (or whatever string is defined in the empty-header-message variable)
  3078. just as in the BCC case. 
  3079.  
  3080. For information on email address formats or help with message header
  3081. editing commands, check the Help for the To: header.
  3082.  
  3083. <End of help on this topic>
  3084. ======= h_composer_from =======
  3085.  
  3086. This header carries your return address.  It is the address toward which
  3087. replies (and often, future unrelated correspondence) will be directed,
  3088. unless you have defined an optional \"Reply-To:\" header.  Make sure this
  3089. address is correct.
  3090.  
  3091. For information on email address formats or help with message header editing
  3092. commands, check the Help for the To: header.
  3093.  
  3094. <End of help on this topic>
  3095. ======= h_composer_reply_to =======
  3096.  
  3097. Most people should not need this header. The Reply-To: header is used in
  3098. cases where you would like replies to your messages to be directed to an
  3099. address other than your normal \"From:\" address.  This is atypical, but
  3100. can happen when you use multiple machines and do not have the same account
  3101. name on each one, or when you wish to direct certain replies to accounts
  3102. or folders designated for specific classes of correspondence.
  3103.  
  3104. For information on email address formats or help with message header editing
  3105. commands, check the Help for the To: header.
  3106.  
  3107. <End of help on this topic>
  3108. ======= h_composer_custom_addr ====
  3109.  
  3110. This is a customized header, i.e. not one that is part of Pine's normal
  3111. set of Compose headers.
  3112.  
  3113. For information on email address formats or help with message header editing
  3114. commands, check the Help for the To: header.
  3115.  
  3116. <End of help on this topic>
  3117. ======= h_composer_custom_free ====
  3118.  
  3119. This is a customized header, i.e. not one that is part of Pine's normal
  3120. set of Compose headers.
  3121.  
  3122. This field consists of arbitrary text.
  3123.  
  3124. For help with message header editing commands, check the Help for the
  3125. To: header.
  3126.  
  3127. <End of help on this topic>
  3128. ====== h_composer_news =====
  3129.  
  3130. Use the Newsgroups line to specify any and all USENET newsgroups to which
  3131. your message should be posted.  When composing a message from scratch, this
  3132. line may be hidden.  If so, just press the rich headers command
  3133. ({F5:Ctrl-R}) to make it visible.
  3134.  
  3135. Be aware that when you post to a newsgroup thousands of people will be reading
  3136. your message.  Also, you or your system manager must have defined a \"nntp-
  3137. server\" in your Pine configuration in order for you to be able to post.
  3138.  
  3139. For help with message header editing commands, check the Help for the
  3140. To: header.
  3141.  
  3142. <End of help on this topic>
  3143. ======= h_composer_fcc ====
  3144.  
  3145. The FCC (File Carbon Copy) specifies the folder used to keep a copy of
  3146. each outgoing message.  The default value can be configured with the
  3147. \"default-fcc\" and \"fcc-name-rule\" options.  You can change or remove
  3148. the file carbon copy on any message you send by editing the FCC header.
  3149.  
  3150. You may type ^T to get a list of all your folders and select one to use as
  3151. the FCC for this message.
  3152.  
  3153. For help with message header editing commands, check the Help for the
  3154. To: header.
  3155.  
  3156. <End of help on this topic>
  3157. ======= h_composer_subject ====
  3158.  
  3159. The subject header provides a place to enter a few words that summarize
  3160. the topic of the message you are sending.  You may leave this line blank,
  3161. but it is considered a courtesy to use a meaningful subject.
  3162.  
  3163. For help with message header editing commands, check the Help for the
  3164. To: header.
  3165.  
  3166. <End of help on this topic>
  3167. ======= h_composer_attachment ====
  3168.  
  3169. This field is where you specify what file or files you'd like attached to
  3170. the message you are composing.  Those files must reside on the machine
  3171. running Pine. If your file is on a PC or Mac and you run Pine with an
  3172. account on a Unix machine, you'll have to transfer it before attaching it.
  3173. Contact local computer support people for assistance with transferring.
  3174.  
  3175. Pine uses MIME encoding for attachments, so binaries and files of any
  3176. length can safely be delivered to any MIME-capable mail reading program.
  3177. If you send an attachment to someone who does not have a MIME-capable mail
  3178. reading program yet, then the main message text will be readable, but
  3179. attachments (even attachments which are just plain text) are not.
  3180.  
  3181. Typing the filename on the Attchmnt: line achieves the same
  3182. result as using the {F6:Ctrl-J} command.
  3183.  
  3184. If you Forward a message with attachments, you may delete them from your
  3185. Forwarded message by editing the Attchmnt header line.
  3186.  
  3187. For help with message header editing commands, check the Help for the
  3188. To: header.
  3189.  
  3190. <End of help on this topic>
  3191. ===== h_composer_sigedit =====
  3192.                       SIGNATURE EDITOR COMMANDS
  3193.  
  3194. CURSOR MOTION KEYS                     |EDITING KEYS
  3195.   ^B (Left Arrow)   Back character     | ^D       Delete current character
  3196.   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
  3197.   ^P (Up Arrow)     Previous line      | ^^       Set a mark
  3198.   ^N (Down Arrow)   Next line          | {F9:^K}       Cut marked text or
  3199.   ^A                Beginning of line  |           delete current line
  3200.   ^E                End of line        | {F10:^U }       Paste text, undelete lines
  3201.   {F7:^Y}                Previous page      |           cut with ^K, or unjustify
  3202.   {F8:^V}                Next page          |-------------------------------------
  3203.   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
  3204. ---------------------------------------| {F6(^W):^W    }   Whereis (search for string)
  3205. MESSAGE COMMANDS | GENERAL COMMANDS    | {F12:^T }      Spell checker
  3206.  {F3:^C}   Cancel     |  {F1:^G}    Get help     | {F4:^J}       Justify paragraph
  3207.                  |  ^Z    Suspend      | ^L       Redraw Screen
  3208.  {F2:^X}   Send       |  {F6:^_}    Alt. editor  | {F5:^R}       Read in a file
  3209.  
  3210. NOTE: The presence or absence of the following commands is determined by
  3211. \"feature-list\" options in your Pine configuration.  Also, some of these
  3212. commands may be administratively disabled by your system manager; if they
  3213. don't work, please check with your local help desk before reporting a bug.
  3214.  
  3215.         o Suspend (suspends Pine and gives a system prompt)
  3216.         o Alternate editor (allows you to compose with your own editor)
  3217.  
  3218. The \"Alternate Editor\" and \"Spell Check\" commands are not available in
  3219. PC-Pine.
  3220.  
  3221. Pine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-], Ctrl-\\, ESC
  3222.  
  3223. NOTE: by default, Pine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
  3224. and XON), as normal characters, even though Pine does not use them.
  3225. However, the printer, modem, or communication software you are using may
  3226. be configured for \"software flow control\" which means that XON/XOFF must
  3227. be treated as special characters by the operating system.  If you see
  3228. messages such as \"^X not defined for this screen\", or if messages
  3229. printed via the \"attached-to-ansi\" option are missing pieces, then your
  3230. system is probably using software flow control. In this case you will need
  3231. to set the \"preserve-start-stop-characters\" feature.  If you *do* set
  3232. this feature, be advised that if you accidentally hit a Ctrl-S, Pine will
  3233. mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
  3234. and see if that puts things right.
  3235.  
  3236. ======= h_composer_abook_nick =======
  3237.  
  3238. This is a short nickname for this address book entry.  If it is used in
  3239. place of an address from the composer, the composer will fill in the
  3240. address(es) for the entry that matches the nickname. 
  3241.  
  3242.                      EDITING and NAVIGATION COMMANDS
  3243.  
  3244. CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
  3245. ^B (Left Arrow)    Back character       | ^D       Delete current character
  3246. ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
  3247. ^P (Up Arrow)      Previous line        |
  3248. ^N (Down Arrow)    Next line            | {F9:^K}       Cut marked text or
  3249. ^A                 Beginning of line    |            delete current line
  3250. ^E                 End of line          | {F10:^U }      Undelete line(s)
  3251. {F7:^Y}                 Previous page        |
  3252. {F8:^V}                 Next page            |-------------------------------------
  3253. ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
  3254. ----------------------------------------|
  3255. EXIT COMMANDS    |  GENERAL COMMANDS    | {F12:^T }    To Addressbook
  3256. {F3:^C}   Cancel      |   {F1:^G}    Get help     | {F12:^R }    RichView 
  3257. (expand lists)
  3258. {F2:^X }  eXit/save   |   ^Z    Suspend      | ^L     Redraw Screen
  3259.  
  3260. <End of help on this topic>
  3261. ======= h_composer_abook_full =======
  3262.  
  3263. This is the full name field for this entry.  If this is going to be a
  3264. distribution list (more than one address), it should be a descriptive
  3265. phrase describing the list.  It will be included in the mail header if you
  3266. put the list in the To: or CC: field, or in the To: line if you put the
  3267. list in the Lcc: field.  It's OK to leave this field blank (and OK to
  3268. leave any of the other fields blank, too).  If this address book entry is
  3269. going to be a simple entry with just one address, then this field is the
  3270. person's name.  When you send mail to this entry, this is the field to the
  3271. left of the brackets.  That is, it is the most readable part of the 
  3272. address.  For example, in the sample address:
  3273.  
  3274.        John Doe <jdoe@some.domain>
  3275.  
  3276. \"John Doe\" is the full name field.  If you are sorting your address book
  3277. with one of the options that uses full names, then it might be useful to
  3278. enter the full name as \"Last, First\", for example:
  3279.  
  3280.        Doe, John
  3281.  
  3282. so that it will be sorted using Doe instead of John.  This will be changed
  3283. back into John Doe when you use it.
  3284.  
  3285. For help with editing and navigation commands, check the Help for the
  3286. Nickname: field.
  3287.  
  3288. <End of help on this topic>
  3289. ======= h_composer_abook_fcc =======
  3290.  
  3291. If this entry is the first one in the To: line of an outgoing message,
  3292. this field will be used for the Fcc (File Carbon Copy) instead of whatever
  3293. you would normally get (which depends on which saved-msg-name-rule you've
  3294. chosen). 
  3295.  
  3296. For help with editing and navigation commands, check the Help for the
  3297. Nickname: field.
  3298.  
  3299. <End of help on this topic>
  3300. ======= h_composer_abook_comment =======
  3301.  
  3302. This is just a comment to help you remember what this entry is.  The WhereIs
  3303. command searches comments so that it is easier to find an entry with a comment
  3304. you know about attached to it.  This field is not used in the outgoing message.
  3305.  
  3306. For help with editing and navigation commands, check the Help for the
  3307. Nickname: field.
  3308.  
  3309. <End of help on this topic>
  3310. ======= h_composer_abook_addrs =======
  3311.  
  3312. This is a list of addresses to send to when sending to this address book
  3313. entry.  Each member of the list may be an address or another nickname from
  3314. any of your address books.  If it is an address, it is OK to include the
  3315. full name field as well as the electronic address portion of that address.
  3316. For example, the following are all legitimate entries in this field:
  3317.  
  3318.      john               (a nickname in your address book)
  3319.      jdoe@some.domain
  3320.      John Doe <jdoe@some.domain>
  3321.  
  3322. The addresses should be listed separated by commas, just like you would
  3323. enter them from the composer.
  3324.  
  3325. The only difference between a distribution list and a simple entry with a
  3326. single address, is that a distribution list has more than one address   
  3327. listed in the Addresses: field, whereas a simple personal entry has just  
  3328. one address.
  3329.  
  3330. For individual address book entries, if there is a full name in the
  3331. Fullname: field (filling in the Fullname: field is not required), it is
  3332. used.  If the full name is specified in the Address: field and not in the
  3333. Fullname: field, then the full name from the Address: field is used.
  3334.  
  3335. If you type the nickname of a distribution list from one of your address 
  3336. books in the Lcc: field, then the full name of that list is used in the  
  3337. To: field.  If you put a list in the To: or Cc: fields, that list will be
  3338. expanded into all of its addresses.  If the list has a full name, then
  3339. that will appear at the beginning of the addresses.
  3340.  
  3341. Sewing Club <john@somewhere>, nancy@something.else, Sal <sal@here.there>
  3342.  
  3343. If the first address in the distribution list also has a full name, then
  3344. the list full name and that full name are combined into something like the
  3345. following:
  3346.  
  3347. Sewing Club -- John Smith <john@somewhere>
  3348.  
  3349. If you specify a list via Lcc, the full name is used in the To: line.  If
  3350. you specify a list in the To: or Cc: fields, then it uses the same method
  3351. as for individual entries for filling in the full name.
  3352.  
  3353. For help with editing and navigation commands, check the Help for the
  3354. Nickname: field.
  3355.  
  3356. <End of help on this topic>
  3357. ======= h_flag_important =======
  3358.  
  3359. Th \"Important\" flag, indicated by an asterisk in Pine's Folder Index
  3360. screen, can only be set by the user, and is intended to be used in
  3361. whatever fashion makes sense to you.  You are the only one that can set or
  3362. clear it. 
  3363.  
  3364. <End of help on this topic>
  3365. ======= h_flag_new =======
  3366.  
  3367. Th \"New\" flag, indicated by the letter 'N' in Pine's Folder Index screen,
  3368. is automatically set when messages are delivered to your Inbox (or other
  3369. folder specified outside of Pine).  Likewise, it is cleared automatically
  3370. the first time you read the message it is associated with.
  3371.  
  3372. Sometimes it's helpful in prioritizing your mail.  For example, perhaps
  3373. a message isn't weighty enough to assign it an \"Important\" flag, but
  3374. you'd like to be reminded of it next time you read mail.  This can be done
  3375. easily by explicitly resetting the \"New\" flag.
  3376.  
  3377. <End of help on this topic>
  3378. ======= h_flag_answered =======
  3379.  
  3380. The \"Answered\" flag, indicated by the letter 'A' in Pine's Folder Index
  3381. screen, is automatically set when you reply to a message.  This flag is not
  3382. automatically cleared.
  3383.  
  3384. NOTE: Technical limitations prevent the current version of Pine from
  3385. being able to automatically flag a message whose reply has been postponed
  3386. as \"Answered\".  This will be fixed in a future release.
  3387.  
  3388. <End of help on this topic>
  3389. ======= h_flag_deleted =======
  3390.  
  3391. The \"Deleted\" flag, indicated by the letter 'D' in Pine's Folder Index
  3392. screen, is set when you use the \"D Delete\" command.  It is cleared
  3393. when you use the \"U Undelete\" command.
  3394.  
  3395. However, there can be other actions implicit in the \"D Delete\" command,
  3396. such as advancing to the next message, that may be momentarily undesirable.
  3397. For this reason, it's sometimes useful to set or clear the \"Deleted\" flag
  3398. explicitly.
  3399.  
  3400. <End of help on this topic>
  3401. ====== h_config_pers_name ======
  3402.         OPTION: Personal-Name
  3403.  
  3404. This value is used to determine the full name part of the \"From\" address
  3405. on messages you send.  If unset, Unix Pine will obtain your full name from
  3406. the system password file.
  3407.  
  3408. <End of help on this topic>
  3409. ====== h_config_pruned_folders ======
  3410.         OPTION: Pruned-folders
  3411.  
  3412. This variable allows you to define a list of one or more folders that
  3413. Pine will offer to prune for you in the same way it automatically offers
  3414. to prune your \"sent-mail\" folder each month.
  3415.  
  3416. That is, once a month for each folder listed, Pine will offer to move
  3417. the contents of the folder to a new folder of the same name but with
  3418. the previous month's date appended.  Pine will then look for any such
  3419. date-appended folder names created for a previous month, and offer each
  3420. one it finds for deletion.
  3421.  
  3422. If you decline the first offer, no mail is moved and no new folder is
  3423. created.
  3424.  
  3425. Folders listed are assumed to exist, and the archive folders will be created,
  3426. in the first collection defined by the \"folder-collections\" variable.
  3427.  
  3428. <End of help on this topic>
  3429. ====== h_config_upload_cmd ======
  3430.         OPTION: Upload-command
  3431.  
  3432. This option affects the behavior of the Composer's \"Read File\" (^R in the
  3433. message body) and \"Attach File\" (^J in the header) commands.  It specifies
  3434. a Unix program name, and any necessary command line arguments, that Pine can
  3435. use to transfer files from your personal computer into messages that you are
  3436. composing.
  3437.  
  3438. Note: this facility is intended for use with serial line transfer 
  3439. protocols, such as kermit, xmodem, or zmodem.  It is *not* intended
  3440. to work with TCP/IP file transfer programs such as ftp.
  3441.  
  3442. If a program is specified, the commands listed above are modified to offer a
  3443. subcommand (^Y) to activate the transfer.  Obviously, the Unix program
  3444. specified here must match the transfer program or protocol available on the
  3445. personal computer.
  3446.  
  3447. Pine expects to exchange uploaded data via a file on your Unix system.  When
  3448. the specified upload program finishes, Pine expects the uploaded data to be
  3449. contained in this file.
  3450.  
  3451. When upload is invoked via the \"Read File\" subcommand, Pine generates a
  3452. temporary file name that it will pass to the specified Unix program.  Pine
  3453. will read the resulting uploaded text from this file and then delete it when
  3454. the upload command is finished.
  3455.  
  3456. When upload is invoked via the \"Attach File\" subcommand, Pine will prompt
  3457. you for the name of the file that is to contain the uploaded information that
  3458. it is to attach.  Pine will attach this file to the composition, but will
  3459. *not* delete this file after the upload command is finished.
  3460.  
  3461. The special token \"_FILE_\" may be included among the Unix program's command
  3462. line arguments.  Pine will replace this symbol with the name of the file
  3463. being used to exchange the uploaded information.  This token allows you to
  3464. position the file name where it is required in the Unix program's command
  3465. line arguments.
  3466.  
  3467. If the \"_FILE_\" token is not present in the specified command, the
  3468. temporary file's name is automatically appended to the specified Unix
  3469. program.  In other words, you don't need to use \"_FILE_\" if it is the
  3470. *last* command line argument.
  3471.  
  3472. <End of help on this topic>
  3473. ====== h_config_upload_prefix ======
  3474.         OPTION: Upload-command-prefix
  3475.  
  3476. This option is used in conjunction with the Upload-command option.
  3477. It defines text to be written to the terminal emulator (via standard output)
  3478. immediately prior to starting upload command.  This is useful for
  3479. integrated serial line file transfer agents that permit command passing
  3480. (e.g., Kermit's APC method).
  3481.  
  3482. The special token \"_FILE_\" may be included in the string specification.
  3483. That symbol will be replaced with the (Pine-created) name of the temporary
  3484. file in which Pine will expect to find the uploaded file.
  3485.  
  3486. <End of help on this topic>
  3487. ====== h_config_download_cmd ======
  3488.         OPTION: Download-command
  3489.  
  3490. This option affects the behavior of the Export command.  It specifies a Unix
  3491. program name, and any necessary command line arguments, that Pine can use to
  3492. transfer the exported message to your personal computer's disk.
  3493.  
  3494. Note: this facility is intended for use with serial line transfer 
  3495. protocols, such as kermit, xmodem, or zmodem.  It is *not* intended
  3496. to work with TCP/IP file transfer programs such as ftp.
  3497.  
  3498. If a program is specified, the Export command is modified to offer a
  3499. subcommand (^V) to activate the transfer (in lieu of saving it to your home
  3500. directory on the machine where Pine is running).  Obviously, the Unix program
  3501. specified here must match the transfer program or protocol available on the
  3502. personal computer.
  3503.  
  3504. When this subcommand is selected and before Pine invokes the specified Unix
  3505. program, Pine will create a temporary file containing the text of the
  3506. exported message.  Pine uses this file to pass the exported message text to
  3507. the specified Unix program.
  3508.  
  3509. The special token \"_FILE_\" may be included among the Unix program's command
  3510. line arguments.  Pine will replace this symbol with the temporary file's name
  3511. before executing the Unix program.  This token allows you to position the
  3512. file name where it is required in the Unix program's command line arguments.
  3513.  
  3514. If the \"_FILE_\" token is not present in the specified command, the
  3515. temporary file's name is automatically appended to the specified Unix
  3516. program.  In other words, you don't need to use \"_FILE_\" if it is the
  3517. *last* command line argument.
  3518.  
  3519. <End of help on this topic>
  3520. ====== h_config_download_prefix ======
  3521.         OPTION: Download-command-prefix
  3522.  
  3523. This option is used in conjunction with the Download-command option.
  3524. It defines text to be written to the terminal emulator (via standard output)
  3525. immediately prior to starting the download command.  This is useful for
  3526. integrated serial line file transfer agents that permit command passing
  3527. (e.g., Kermit's APC method).
  3528.  
  3529. The special token \"_FILE_\" may be included in the string specification.
  3530. That symbol will be replaced with the (Pine-created) name of the temporary
  3531. file into which Pine will place the message to be downloaded.
  3532.  
  3533. <End of help on this topic>
  3534. ====== h_config_mailcap_path ======
  3535.         OPTION: mailcap-search-path
  3536.  
  3537. This variable is used to replace Pine's default mailcap file search path.
  3538. It takes one or more file names (full paths must be specified) in which to
  3539. look for mail capability data.  The default search path can be found in the
  3540. release notes (\"R\" command off the main menu).
  3541.  
  3542.         ~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
  3543.  
  3544. If there is more than one file name listed, list members should be delimited
  3545. by a colon (:) under UNIX and a semi-colon (;) under DOS.
  3546.  
  3547. <End of help on this topic>
  3548. ====== h_config_mimetype_path ======
  3549.         OPTION: mimetype-search-path
  3550.  
  3551. This variable is used to replace Pine's default mime.types file search path.
  3552. It takes one or more file names (full paths must be specified) in which to
  3553. look for file-name-extension to MIME type mapping data.  The default search
  3554. path can be found in the release notes (\"R\" command off the main menu).
  3555.  
  3556. If there is more than one file name listed, list members should be delimited
  3557. by a colon (:) under UNIX and a semi-colon (;) under DOS.
  3558.  
  3559. <End of help on this topic>
  3560. ====== h_config_set_att_ansi ======
  3561.         OPTION: Set printer to attached ansi printer
  3562.  
  3563. Type \"S\" to set your printer to \"attached-to-ansi\".
  3564. It is OK to include \"attached-to-ansi\" in your personal list below.
  3565.  
  3566. <End of help on this topic>
  3567. ====== h_config_set_att_ansi2 ======
  3568.         OPTION: Set printer to attached ansi printer (no formfeed)
  3569.  
  3570. Type \"S\" to set your printer to \"attached-to-ansi-no-formfeed\".
  3571. It is OK to include \"attached-to-ansi-no-formfeed\" in your personal
  3572. list below.
  3573.  
  3574. This is the same as the \"attached-to-ansi\" option except that a
  3575. formfeed character will not be appended to the end of the print job.
  3576. If your printer already ejects the paper by itself at the end of the
  3577. job, you may prefer the \"no-formfeed\" form of this printer so that you
  3578. don't get an extra blank page between print jobs.
  3579.  
  3580. <End of help on this topic>
  3581. ====== h_config_set_stand_print ======
  3582.         OPTION: Set default printer
  3583.  
  3584. Move to the printer you want and type \"S\" to set it to be your
  3585. default printer.  This list is not modifiable by you and has been
  3586. set up by the system administrators.  If there is more than one printer
  3587. listed in the Command List, you will be able to cycle through that
  3588. whole list at the time you print, starting with your default.
  3589. It is OK to include entries from this Standard list in your personal
  3590. list below.
  3591.  
  3592. <End of help on this topic>
  3593. ====== h_config_set_custom_print ======
  3594.         OPTION: Set default printer
  3595.  
  3596. You may add as many print commands as you want to your personal list.
  3597. Specify one of them as your default printer by moving to the printer
  3598. you want and typing \"S\".  If there is more than one printer listed
  3599. in the Command List, you will be able to cycle through that list at
  3600. the time you print, starting with your default.  It is OK to include
  3601. entries from the Standard list above or to include the command
  3602. \"attached-to-ansi\" or \"attached-to-ansi-no-formfeed\" as one of the
  3603. entries here.
  3604.  
  3605. <End of help on this topic>
  3606. ====== h_config_user_id =====
  3607.         OPTION: User-Identification
  3608.  
  3609. This value is used as part of the \"From\" address on messages you send.
  3610. It is also the default login name for remote IMAP server access.  Set this
  3611. to the username part you want to appear on outgoing email.
  3612.  
  3613. <End of help on this topic>
  3614. ====== h_config_user_dom =====
  3615.         OPTION: User-Domain
  3616.  
  3617. This value specifies the domain part (right-hand side) of your return
  3618. address on outgoing email and is also used as the default domain for email
  3619. composed to a local user.  If unset, Unix Pine will obtain the domain from
  3620. the system.  Often this value will be set for your whole site by the
  3621. system administrator.
  3622.  
  3623. If you set this, see also the \"quell-user-lookup-in-passwd-file\" feature.
  3624.  
  3625.  
  3626. <End of help on this topic>
  3627. ====== h_config_smtp_server =====
  3628.         OPTION: SMTP-Server
  3629.  
  3630. This value specifies the name of one or more SMTP servers for sending
  3631. mail. You must have an SMTP server for use with PC-Pine.  SMTP servers are
  3632. normally setup by a system administrator for use by all members of a given
  3633. campus or department.  Contact your local help desk to ask what SMTP
  3634. servers you should use.  Unix Pine users do not need to use an SMTP server
  3635. and can leave this blank.
  3636.  
  3637. <End of help on this topic>
  3638. ====== h_config_nntp_server =====
  3639.         OPTION: NNTP-Server
  3640.  
  3641. This value specifies the name of the NNTP (Network News Transfer Protocol)
  3642. server for reading and posting USENET news.  NNTP servers are normally
  3643. setup by a system administrator for use by all members of a given campus
  3644. or department.  Contact your local help desk to ask what NNTP servers you
  3645. should use.  Often Unix Pine users will find that this variable has been
  3646. set for the whole system (and you don't have to worry about it).  When you
  3647. define an NNTP server here, Pine implicitly defines a news collection for
  3648. you, assuming that server as the news server and assuming that you will
  3649. use the NNTP protocol and a local newsrc configuration file for reading
  3650. news.  For more about reading news with Pine, see the release notes.
  3651.  
  3652. <End of help on this topic>
  3653. ====== h_config_inbox_path =====
  3654.         OPTION: Inbox-Path
  3655.  
  3656. This value overrides the default value of your INBOX name/path/location.
  3657. PC-Pine users must specify an inbox path and it must be a folder on an
  3658. IMAP server.  Unix and VMS Pine users will often find that this variable
  3659. has been pre-configured by your system administrator.  You may be able to
  3660. specify an alternate INBOX which is either a local folder or a folder on
  3661. an IMAP server.
  3662.  
  3663. A typical remote inbox-path entry would be: {{:{}monet.art.nowhere.edu}INBOX
  3664. where \"monet.art.nowhere.edu\" is replaced by the name of your IMAP
  3665. mail server.
  3666.  
  3667. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  3668. press \"?\" for Help... Look for the section \"Valid Folder Names\".
  3669.  
  3670. <End of help on this topic>
  3671. ====== h_config_folder_spec =====
  3672.         OPTION: Folder-Collections
  3673.  
  3674. Folder collections are \"places\" to store folders.  They roughly
  3675. correspond to a filesystem \"directory\". Pine will normally provide you
  3676. with one folder collection by default.  Using this option, you may
  3677. specify additional collections.  These collections may be local or remote,
  3678. but they must correspond to a pre-existing filesystem directory, i.e.
  3679. Pine will not create any directory other than the original default.
  3680.  
  3681. The first folder collection listed here is the default collection for the
  3682. Save command -- the place various folders are put unless you specify
  3683. otherwise.
  3684.  
  3685. A valid local collection is just the specification of a directory on the
  3686. local system followed by square brackets.  For example, \"ART-101\\[]\" may
  3687. be valid on a PC and \"exhibit/[]\" may be valid on Unix.
  3688.  
  3689. Pine also allows you to access a collection on a remote computer (provided
  3690. it supports IMAP and you have the right to store folders on it).
  3691. To specify a remote folder collection, you need to give the name of the
  3692. IMAP mail server, the name of the collection on that server, and the square
  3693. brackets.  For instance, \"{{:{}wharhol.art.nowhere.edu}art-101/[]\" is a
  3694. remote collection.  As you can tell, the name of the computer is in {{:{}}
  3695. brackets followed immediately by the name of the collection.
  3696.  
  3697. Collection syntax:
  3698.  
  3699.  optional-label {{:{}optional-imap-hostname}optional-directory-path[]
  3700.  
  3701. Additional examples:
  3702.  
  3703.  Saved-Email {{:{}klee.art.nowhere.edu}mail/[]  <-- Remote collection
  3704.  Widget-Project widget/[]                   <-- Local collection (Unix)
  3705.  Desktop        MAIL\\[]                    <-- Local collection (PC)
  3706.  
  3707. Use the following SETUP CONFIGURATION commands to manipulate your folder
  3708. collections list:
  3709.  
  3710.  {F9 : A}  Add Value
  3711.  {F10: D}  Delete Value
  3712.  {F4 : C}  Change the current setting
  3713.  
  3714. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  3715. press \"?\" for Help... Look for the section on \"Folder Collections\".
  3716.  
  3717. <End of help on this topic>
  3718. ====== h_config_news_spec =====
  3719.          OPTION: News-Collections
  3720.  
  3721. This value defines one or more collections of incoming newsgroup folders;
  3722. however, most people will not need to use this option since setting the
  3723. nntp-server option will implicitly define the most common news-collection
  3724. configuration.
  3725.  
  3726. You can use this to set a specific news collection other than that defined
  3727. implicitly by defining an NNTP server.  News collections defined here can
  3728. take several forms:
  3729.  
  3730.   Partial newsfeeds:            News *{{:{}news.nowhere.edu/nntp}[comp.*]
  3731.   News on the local host:       News *[]
  3732.   Newsfeeds accessed via IMAP:  News *{{:{}news.nowhere.edu}[]
  3733.  
  3734. FOR MORE INFORMATION on collections, check the help for the \"Folder
  3735. Collections\" option above and the help for the FOLDER LIST screen.
  3736.  
  3737. <End of help on this topic>
  3738. ====== h_config_default_fcc =====
  3739.          OPTION: Default-FCC (File Carbon Copy)
  3740.  
  3741. This value specifies where a copy of outgoing mail should be saved.  If
  3742. this is not a path name, it will be in the default collection for saves.
  3743. Any valid folder specification, local or IMAP, is allowed.  This default
  3744. folder carbon copy only applies when the fcc-rule-name (see later in this
  3745. configuration screen) is set to use the default folder.  Unix Pine default
  3746. is normally \"sent-mail\" in the default folder collection. PC-Pine
  3747. default is \"SENTMAIL\" (normally stored as SENTMAIL.MTX)
  3748.  
  3749. To suppress saving of outgoing mail, set: default-fcc=\"\"
  3750.  
  3751. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  3752. press \"?\" for Help... Look for the section \"Valid Folder Names\".
  3753.  
  3754. <End of help on this topic>
  3755. ====== h_config_def_save_folder =====
  3756.          OPTION: Default-Saved-Msg-Folder
  3757.  
  3758. This option determines the default folder name for Saves...  If
  3759. this is not a path name, it will be in the default collection for saves.
  3760. Any valid folder specification, local or IMAP, is allowed.  This default
  3761. folder only applies when the saved-msg-name-rule (see later in this
  3762. configuration screen) doesn't override it.  Unix Pine default
  3763. is normally \"saved-messages\" in the default folder collection. PC-Pine
  3764. default is \"SAVEMAIL\" (normally stored as SAVEMAIL.MTX)
  3765.  
  3766. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  3767. press \"?\" for Help... Look for the section \"Valid Folder Names\".
  3768.  
  3769. <End of help on this topic>
  3770. ====== h_config_postponed_folder =====
  3771.          OPTION: Postponed-Folder
  3772.  
  3773. This value overrides the default name for the folder where postponed
  3774. messages are saved.  If this is not a path name, it will be in the default
  3775. collection for message Saves.  Any valid folder specification, local or
  3776. remote, is allowed.  The Unix Pine default is normally \"postponed-msgs\"
  3777. in the default collection. PC-Pine default is \"POSTPOND\" (stored as
  3778. POSTPOND.MTX).
  3779.  
  3780. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  3781. press \"?\" for Help... Look for the section \"Valid Folder Names\".
  3782.  
  3783. <End of help on this topic>
  3784. ====== h_config_read_message_folder =====
  3785.          OPTION: Read-Message-Folder
  3786.  
  3787. By virtue of specifying a folder name here, Pine will be configured to
  3788. save all messages which you have read during a session into the designated
  3789. \"read messages\" folder.  This allows you to more easily distinguish
  3790. between your really new email (in your INBOX) and those which you have
  3791. already read.  Depending on how you define the \"auto-move-read-messages\"
  3792. setting in the \"feature-list\", you may or may not be asked when you quit
  3793. Pine if you want read messages to be moved to this folder.  In either
  3794. case, moving the messages means they will be deleted from your INBOX.
  3795.  
  3796. If this is not a path name, it will be in the default collection for
  3797. saves.  Any valid folder specification, local or remote (via IMAP), is
  3798. allowed.  There is no default for the name of the read message folder.
  3799.  
  3800. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  3801. press \"?\" for Help and look for the section \"Valid Folder Names\".
  3802.  
  3803. <End of help on this topic>
  3804. ====== h_config_archived_folders =====
  3805.          OPTION: Incoming-Archive-Folders
  3806.  
  3807. This is like Read-Message-Folder, only more general.  You may archive
  3808. any of the folders in your incoming collection.  This is a list of folder
  3809. pairs, with the first separated from the second in the pair by a space.
  3810. The first folder in a pair is the folder you want to archive, and the
  3811. second folder is the folder that read messages from the first should be
  3812. moved to.  Depending on how you define the \"auto-move-read-messages\"
  3813. setting in the \"feature-list\", you may or may not be asked when you
  3814. leave the first folder if you want read messages to be moved to the
  3815. second folder.  In either case, moving the messages means they will be
  3816. deleted from the first folder.
  3817.  
  3818. If these are not path names, they will be in the default collection for
  3819. saves.  Any valid folder specification, local or remote (via IMAP), is
  3820. allowed.  There is no default.
  3821.  
  3822. FOR MORE INFORMATION: From the Main Menu, select \"L FOLDER LIST\" and
  3823. press \"?\" for Help and look for the section \"Valid Folder Names\".
  3824.  
  3825. <End of help on this topic>
  3826. ====== h_config_newsrc_path ======
  3827.         OPTION: newsrc-path
  3828.  
  3829. This option overrides the default name Pine uses for your \"newsrc\" news
  3830. status and subscription file.  If set, Pine will take this value as the
  3831. full pathname for the desired newsrc file.
  3832.  
  3833. If this option is not set, Unix Pine looks for the file ~/.newsrc and
  3834. PC-Pine looks first for  $HOME\\NEWSRC  (where $HOME defaults to the root
  3835. of the current drive, e.g. \"C:\\\" ) and then it looks in the same
  3836. directory as your pinerc file for NEWSRC.
  3837.  
  3838. <End of help on this topic>
  3839. ====== h_config_signature_file =====
  3840.         OPTION: Signature-File
  3841.  
  3842. This is the name of a file which will be automatically inserted into
  3843. outgoing messages.  It typically contains information such as your name,
  3844. email address and organizational affiliation.  Pine adds the signature
  3845. into the message as soon as you enter the composer so you can choose to
  3846. remove it on a message by message basis.  Signature file placement in
  3847. message replies is controlled by the \"signature-at-bottom\" setting in
  3848. the feature list.
  3849.  
  3850. The default file name on Unix is \".signature\"; on PC-Pine the file is in
  3851. the same directory as your PINERC file, under the name \"\\PINE.SIG\".
  3852. The signature file must be kept on the local system, not a remote IMAP
  3853. server.
  3854.  
  3855. To create or edit your signature file choose Setup from the Main Menu
  3856. and then select S for Signature (Main/Setup/Signature).  This puts you
  3857. into the Signature Editor where you can enter a *few* lines of text
  3858. containing your identity and affiliation.
  3859.  
  3860. <End of help on this topic>
  3861. ====== h_config_addressbook =====
  3862.         OPTION: Address-Book
  3863.  
  3864. This value overrides the default name of your personal address book file.
  3865. You may also define additional personal address books, to which you
  3866. may add selected addresses from within Pine.
  3867.  
  3868. The default is to have a single address book.  On Unix the file is named
  3869. \"~/.addressbook\" and on PCs the file is in the same directory as your
  3870. PINERC file, under the name \"\\ADDRBOOK\".
  3871.  
  3872. At this time address books must be kept on the local system, not a remote
  3873. IMAP server.  If you override the default name for PC-Pine's addressbook,
  3874. do not add a filename extension, since Pine will use your specified name
  3875. and add a \".lu\" extension when it generates its auxiliary index (look
  3876. up) file.
  3877.  
  3878. You may optionally precede the file name with a label that will be used
  3879. for identification in the ADDRESS BOOK display.  For example:
  3880.  
  3881.    PERSONAL addrbook
  3882.  
  3883. <End of help on this topic>
  3884. ====== h_config_global_addrbook ==========
  3885.         OPTION: Global-Address-Book
  3886.  
  3887. This value specifies the name(s) of global (system-wide) address books. 
  3888. Defining these will typically be done in the system-wide Pine
  3889. configuration file by your system administrator.  This option may be used
  3890. to specify a shared workgroup addressbook, or to override the system-wide
  3891. default, if it exists. 
  3892.  
  3893. You may optionally precede the file name with a label that will be used
  3894. for identification in the ADDRESS BOOK display.  For example:
  3895.  
  3896.    WORKGROUP wgaddrbk
  3897.  
  3898. Global address books must be accessible via normal file access routines
  3899. on the machine where Pine is running.  Unlike personal address books,
  3900. global address books may not be modified/updated from within Pine;
  3901. that is, they are Read-Only.
  3902.  
  3903. There is no default value for this option.
  3904.  
  3905. <End of help on this topic>
  3906. ====== h_config_init_cmd_list =====
  3907.         OPTION: Initial-Keystroke-List
  3908.  
  3909. The initial keystroke --or command-- list option lets you start Pine at
  3910. any place you like.  Whatever keystrokes you specify here will be executed
  3911. by Pine upon startup as a macro.  The words SPACE, TAB, DOWN, UP, LEFT, and
  3912. RIGHT indicate the pressing of those keys.  CR indicates the pressing of
  3913. the RETURN key.  F1 through F12 represent the function keys.  For example,
  3914. to view message 1 on startup, you would specify i,j,1,CR,v.
  3915.  
  3916. Restriction: You cannot pre-type into the composer with the initial
  3917. keystroke list.
  3918.  
  3919. <End of help on this topic>
  3920. ====== h_config_comp_hdrs =====
  3921.         OPTION: Default-Composer-Headers
  3922.  
  3923. You can decide which headers you want visible when composing outgoing
  3924. email using this option.  You can specify any of the regular set, any rich
  3925. header or any custom header which you have already defined.  If you use
  3926. this setting at all, you must specify all the headers you want to see, you
  3927. can't just add to the regular header set.  The default set is To:, Cc:,
  3928. Attchmnt:, and Subject:.
  3929.  
  3930. Note that the \"Newsgroups:\" header will be abbreviated in the Composer
  3931. display, but should be spelled-in-full here.
  3932.  
  3933. <End of help on this topic>
  3934. ====== h_config_custom_hdrs =====
  3935.         OPTION: Customized-Headers
  3936.  
  3937. You may add your own custom headers to all outgoing messages.  Each header
  3938. you specify here must include the header tag (Reply-To:, Approved:, etc.)
  3939. and may optionally include a value for that header.  If you want to see
  3940. these custom headers each time you compose a message, you must add them to
  3941. your default composer headers list (see above), otherwise they become part
  3942. of the rich header set which you only see when you press the rich header
  3943. (Ctrl-R) command.
  3944.  
  3945. <End of help on this topic>
  3946. ====== h_config_viewer_headers =====
  3947.         OPTION: Viewer-Headers
  3948.  
  3949. You may change the default list of headers that are viewed by listing
  3950. the headers you want to view here.  If the headers in your \"viewer-hdrs\"
  3951. list are present in the message, then they will be shown.  The order of
  3952. the headers you list will be honored.  If the special value \"all-except\"
  3953. is included as the first header in the \"viewer-hdrs\" list, then all headers
  3954. in the message except those in the list will be shown.  The values are
  3955. all case insensitive.
  3956.  
  3957. Note that once you put anything in the \"viewer-hdrs\" list, then the
  3958. original default headers are ignored.  So, if you just wanted to add
  3959. the header Organization to the list, you'd have to list Organization plus
  3960. all of the other headers originally in the default list.  If you just
  3961. included Organization and nothing else, then you'd see only the Organization
  3962. header, nothing else.
  3963.  
  3964. The default list of headers includes:  From, Resent-From, To, Resent-To,
  3965. Cc, Resent-cc, Bcc, Newsgroups, Followup-To, Date, Resent-Date,
  3966. Subject, Resent-Subject, and Reply-To.
  3967.  
  3968. <End of help on this topic>
  3969.  
  3970. ====== h_config_saved_msg_name_rule =====
  3971.         OPTION: Saved-Msg-Name-Rule
  3972.  
  3973. This option determines the default folder name when saving (i.e. using
  3974. the Save option) a message.  Choose one of the following:
  3975. default-folder, last-folder-used, by-from, by-sender, by-recipient,
  3976. by-nick-of-from, by-nick-of-sender, by-nick-of-recip, by-fcc-of-from,  
  3977. by-fcc-of-sender, by-fcc-of-recip, by-nick-of-from-then-from,
  3978. by-nick-of-sender-then-sender, by-nick-of-recip-then-recip,
  3979. by-fcc-of-from-then-from,  by-fcc-of-sender-then-sender,
  3980. or by-fcc-of-recip-then-recip.
  3981.  
  3982. The default option is \"default-folder\", which is the folder called 
  3983.  \"saved-messages\" in Unix Pine and \"savemail\" in PC-Pine.  To change
  3984. the default folder, modify the variable called 
  3985. \"default-saved-msg-folder\". 
  3986.  
  3987. Choosing any of the \"by-\" options cause Pine to attempt to get the
  3988. chosen option's value for the message being saved.  For example, if
  3989. \"by-from\" is chosen, Pine attempts to get the value of who the message
  3990. came from (i.e. the from address).  Pine then attempts to save the message
  3991. to a folder matching that value. If \"by-from\" is chosen and no value is
  3992. obtained, Pine uses \"by-sender\". The opposite is also true.  If
  3993. \"by-recipient\" was chosen and the message was posted to a newsgroup,
  3994. Pine will use the newsgroup name. 
  3995.  
  3996. If any of the \"by-nick\" options are chosen, the resulting address is
  3997. looked up in the user's address book and if found, the nickname for that
  3998. entry is used.  Similarly, if any of the \"by-fcc\" options are chosen,
  3999. the fcc from the corresponding address book entry is used.  If no value
  4000. is found in the address book, then if the chosen option ends with the
  4001. \"then-from\", \"then-sender\", or \"then-recip\" suffix, Pine reverts to
  4002. the same behavior as \"by-from\", \"by-sender\" or \"by-recipient\"
  4003. depending on which option was specified.  If the chosen option doesn't
  4004. end with one of the \"then-\" suffixes, then Pine reverts to the default
  4005. folder when no match is found in the address book.
  4006.  
  4007. Choosing the option called \"last-folder-used\", causes Pine to save to
  4008. the folder that you saved to the last time you saved a message.  The first
  4009. time you save a message in a Pine session, Pine attempts to save the
  4010. message to the default folder. 
  4011.  
  4012. <End of help on this topic>
  4013. ====== h_config_fcc_rule =====
  4014.         OPTION: FCC-Name-Rule
  4015.  
  4016. This option determines the default name for folder carbon copy. Choose
  4017. one: default-fcc, last-fcc-used, by-recipient, by-nickname,
  4018. by-nick-then-recip, or current-folder.
  4019.  
  4020. Normal default is \"default-fcc\", the value of which is set in
  4021. the \"default-fcc\" variable as specified earlier in this configuration.
  4022.  
  4023. The option \"last-fcc-used\" puts the folder that was last used in the fcc 
  4024. field.
  4025.  
  4026. The option \"by-nickname\" means that it will use the nickname from your
  4027. address book that matches the first address in the To line.  If there is
  4028. no match, it will use the value of the \"default-fcc\" variable.
  4029.  
  4030. The option \"by-recipient\" means it will form a folder name based on
  4031. the left hand side of the first address in the To line.
  4032.  
  4033. The option \"by-nick-then-recip\" means that it will use the matching
  4034. nickname from your address book if there is one, otherwise it will
  4035. extract the recipient name from the address and use that (like
  4036. by-recipient).
  4037.  
  4038. The option \"current-folder\" causes a copy to be written to the currently 
  4039. open folder, unless that is the INBOX.  In the case where the current 
  4040. folder is the INBOX, the \"default-fcc\" is used instead.
  4041.  
  4042. Note that whatever the fcc specified by the rule here, it will be
  4043. over-ridden by any fcc entries you have in your address book.
  4044.  
  4045. <End of help on this topic>
  4046. ====== h_config_sort_key =====
  4047.         OPTION: Sort-Key
  4048.  
  4049. This option determines the order in which messages will be displayed in
  4050. the Folder Index screen.  Choose from:
  4051.  
  4052.  o Date -- Sort folders according to the date and time they were
  4053.      sent. On a folder like INBOX, sorting by \"Date\" should be almost
  4054.      identical to sorting by \"Arrival\".
  4055.  o Arrival -- Sort messages into the order in which they arrived.
  4056.  o From -- Sort messages by the name of the author of the message.
  4057.      Messages with the same author are grouped together. Groups of
  4058.      messages are then put into alphabetical order according to message
  4059.      author.
  4060.  o Subject -- Sort messages by subject. Messages with the same
  4061.      subject are grouped together. Pine ignores leading \"Re:\" and \"re:\"
  4062.      and trailing \"(fwd)\" when determining the likeness and
  4063.      alphabetical order of subject lines. Groups of messages are put
  4064.      into alphabetical order according to subject.
  4065.  o OrderedSubj -- Grouping of all messages with the same subject
  4066.      together is done in the same way as sort by subject. With
  4067.      \"OrderedSubj\" however, groups of messages are put into date order
  4068.      according to the oldest message on a given subject. This sorting
  4069.      provides pseudo threading of messages.
  4070.  o ReverseDate -- Like \"Date\" but the newest message is first.
  4071.  o ReverseArrival -- Like \"Arrival\" but the newest message is first.
  4072.  o ReverseFrom -- Like \"From\" but groups of messages are ordered in
  4073.      reverse alphabetical order (Z-A).
  4074.  o ReverseSubject -- Like \"Subject\" but groups of messages are
  4075.      ordered in reverse alphabetical order (Z-A).
  4076.  o ReverseOrderedSubj -- Like \"OrderedSubj\" but groups of messages
  4077.      are ordered with the newest groups first (according to the first
  4078.      message of each group).
  4079.  
  4080. Normal default is \"arrival\".
  4081.  
  4082. <End of help on this topic>
  4083. ====== h_config_ab_sort_rule =====
  4084.         OPTION: Address-Book-Sort-Rule
  4085.  
  4086. This option controls the order in which address book entries will be
  4087. presented.  Choose one of the following:
  4088.  
  4089. fullname                  use fullname field, lists mixed in
  4090. fullname-with-lists-last  use fullname field, but put lists at end
  4091. nickname                  use nickname field, lists mixed in
  4092. nickname-with-lists-last  use nickname field, but put lists at end
  4093. dont-sort                 don't change order of file
  4094.  
  4095. The normal default is \"fullname-with-lists-last\".
  4096.  
  4097. <End of help on this topic>
  4098. ====== h_config_char_set =====
  4099.         OPTION: Character-Set
  4100.  
  4101. The character set is used primarily to mark outgoing email appropriately.
  4102. Set it to whatever character set you might use to compose messages.
  4103. Whenever you actually send a message, Pine checks it to see if it is, in
  4104. fact, US-ASCII (a subset of the other sets allowable). If it is US-ASCII,
  4105. the outgoing message will be marked as such no matter what you have set as
  4106. your character set. Normal default is US-ASCII.  Typical alternatives
  4107. include ISO-8859-x, where x is a number between 1 and 9.
  4108.  
  4109. <End of help on this topic>
  4110. ====== h_config_editor =====
  4111.         OPTION: Editor
  4112.  
  4113. Editor specifies the program invoked by ^_ in the Composer. This is
  4114. normally an alternative to Pine's internal composer (Pico).  You could use
  4115. this setting to specify an alternate editor to use occasionally or if you
  4116. have a favorite editor and want to use it all the time (see the \"enable-
  4117. alternate-editor-implicitly\" setting).
  4118.  
  4119. <End of help on this topic>
  4120. ====== h_config_speller =====
  4121.         OPTION: Speller
  4122.  
  4123. This option affects the behavior of the ^T (spell check) command in the
  4124. Composer.  It specifies the program invoked by ^T in the Composer.  By
  4125. default, Pine uses the system's \"spell\" command.  Pine will use the
  4126. command defined by this option (if any) instead.  When invoking the
  4127. spell-checking program, Pine appends a tempfile name (where the message is
  4128. passed) to the command line.
  4129.  
  4130. <End of help on this topic>
  4131. ====== h_config_display_filters =====
  4132.         OPTION: Display-Filters
  4133.  
  4134. This option defines a list of text-filtering commands (programs or
  4135. scripts) that may be used to filter text portions of received messages
  4136. prior to their use (e.g., presentation in the \"MESSAGE TEXT\" display
  4137. screen).  For security reasons, the full path name of the filter command 
  4138. must be specified. 
  4139.  
  4140. The command is executed and the message is piped into its standard input. 
  4141. The standard output of the command is read back by Pine.  The
  4142. \"_TMPFILE_\" token (see below) overrides this default behavior. 
  4143.  
  4144. The filter's use is based on the configured \"trigger\" string.  The
  4145. format of a filter definition is:
  4146.    
  4147.         <trigger> <command> <arguments>
  4148.  
  4149. You can specify as many filters as you wish, separating them with a comma.  
  4150. Each filter can have only one trigger and command.  Thus, two trigger 
  4151. strings which invoke the same command require separate filter 
  4152. specifications. 
  4153.  
  4154. The \"trigger\" is simply text that, if found in the message, will invoke
  4155. the associated command.  If the trigger contains any space characters, it
  4156. must be placed within quotes.  Likewise, should you wish a filter to be
  4157. invoked unconditionally, define the trigger as the null string, \"\" (two
  4158. consecutive double-quote characters).  If the trigger string is found
  4159. anywhere in the text of the message the filter is invoked.  Placing the
  4160. trigger text within the tokens defined below changes where within the text
  4161. the trigger must be before considering it a match. 
  4162.   
  4163.  Trigger Modifying Tokens:
  4164.  
  4165.    _CHARSET(string)_    This token tells Pine to invoke the supplied command
  4166.                         if the text is in a character set matching \"string\"
  4167.                         (e.g., ISO-8859-2 or ISO-2022-JP).
  4168.  
  4169.    _LEADING(string)_    This token tells Pine to invoke the supplied command
  4170.                         if the enclosed \"string\" is found to be the first
  4171.                         non-whitespace text.
  4172.                         NOTE: Quotes are necessary if \"string\" contains
  4173.                               the space character.
  4174.  
  4175.    _BEGINNING(string)_  This token tells Pine to invoke the supplied command
  4176.                         if the enclosed \"string\" is found at the beginning
  4177.                         of any line in the text.
  4178.                         NOTE: Quotes are necessary if \"string\" contains
  4179.                               the space character.
  4180.  
  4181. The \"command\" and \"arguments\" portion is simply the command line to be
  4182. invoked if the trigger string is found.  Below are tokens that Pine will
  4183. recognize and replace with special values when the command is actually
  4184. invoked. 
  4185.  
  4186. Command Modifying Tokens:
  4187.  
  4188.    _RECIPIENTS_         When the command is executed, this token is replaced 
  4189.                         with the space delimited list of recipients of the 
  4190.                         message being displayed.
  4191.                         
  4192.    _TMPFILE_            When the command is executed, this token is 
  4193.                         replaced with the path and name of the temporary 
  4194.                         file containing the text to be filtered.  Pine 
  4195.                         expects the filter to replace this data with the 
  4196.                         filter's result.
  4197.  
  4198.                         Note: Use of this token implies that the text to 
  4199.             be filtered is not piped into standard input of the 
  4200.             executed command and its standard output is ignored. 
  4201.             Pine restores the tty modes before invoking the
  4202.                         filter in case the filter interacts with the user
  4203.                         via its own standard input and output.  
  4204.                         
  4205.    _RESULTFILE_         When the command is executed, this token is 
  4206.             replaced with the path and name of a temporary 
  4207.             file intended to contain a status message from the 
  4208.             filter.  Pine displays this in the message status 
  4209.             field. 
  4210.  
  4211.    _DATAFILE_           When the command is executed, this token is 
  4212.             replaced with the path and name of a temporary 
  4213.             file that Pine creates once per session and deletes 
  4214.             upon exit.  The file is intended to be used by the 
  4215.             filter to store state information between instances 
  4216.             of the filter.
  4217.    
  4218.    _PREPENDKEY_         When the command is executed, this token indicates 
  4219.             that a random number will be passed down the input 
  4220.             stream before the message text.  This number could 
  4221.             be used as a session key.  It is sent in this way 
  4222.             to improve security.  The number is unique to the 
  4223.             current Pine session and is only generated once per 
  4224.             session. 
  4225.  
  4226. Performance caveat/considerations:
  4227.  
  4228. Testing for the trigger and invoking the filter doesn't come for free.
  4229. There is overhead associated with searching for the trigger string, testing
  4230. for the filter's existence and actually piping the text through the filter.
  4231. The impact can be reduced if the Trigger Modifying Tokens above are 
  4232. employed.
  4233.  
  4234. <End of help on this topic>
  4235. ====== h_config_sending_filter =====
  4236.         OPTION: Sending-Filters
  4237.       
  4238. This option defines a list of text-filtering commands (programs and
  4239. scripts) that may be selectively invoked to process a message just before
  4240. it is sent.  If set, the Composer's ^X (Send) command will allow you to
  4241. select which filter (or none) to apply to the message before it is sent. 
  4242. For security reasons, the full path of the filter program must be
  4243. specified. 
  4244.  
  4245.  Command Modifying Tokens:
  4246.  
  4247.    _RECIPIENTS_         When the command is executed, this token is replaced 
  4248.             with the space delimited list of recipients of the 
  4249.             message being sent. 
  4250.         
  4251.    _TMPFILE_            When the command is executed, this token is 
  4252.             replaced with the path and name of the temporary 
  4253.             file containing the text to be filtered.  Pine 
  4254.             expects the filter to replace this data with the 
  4255.             filter's result.
  4256.  
  4257.             Note: Use of this token implies that the text to 
  4258.             be filtered is not piped into standard input of the 
  4259.             executed command and its standard output is ignored. 
  4260.             Pine restores the tty modes before invoking the
  4261.                         filter in case the filter interacts with the user
  4262.                         via its own standard input and output.  
  4263.                         
  4264.    _RESULTFILE_         When the command is executed, this token is 
  4265.             replaced with the path and name of a temporary 
  4266.             file intended to contain a status message from the 
  4267.             filter.  Pine displays this in the message status 
  4268.             field. 
  4269.  
  4270.    _DATAFILE_           When the command is executed, this token is replaced 
  4271.             in the command line with the path and name of a 
  4272.             temporary file that Pine creates once per session 
  4273.             and deletes upon exit.  The file is intended to be 
  4274.                used by the filter to store state information between 
  4275.             instances of the filter.
  4276.    
  4277.    _PREPENDKEY_         When the command is executed, this token indicates 
  4278.             that a random number will be passed down the input 
  4279.             stream before the message text.  This number could 
  4280.             be used as a session key.  It is sent in this way 
  4281.             to improve security.  The number is unique to the 
  4282.             current Pine session and is only generated once per 
  4283.             session. 
  4284.    
  4285. NOTE: Only the body text, which is visible in the Composer, is piped
  4286.       through this filter.  Attachments are not sent to the filter.
  4287.                         
  4288. <End of help on this topic>
  4289. ====== h_config_alt_addresses =====
  4290.         OPTION: Alt-Addresses
  4291.  
  4292. This option provides a place for you to list alternative email addresses
  4293. you may have.  If set, the option affects the behavior of the Reply
  4294. command and the \"+\" symbol in the Folder Index, which denotes that
  4295. a message has been addressed specifically to you.
  4296.  
  4297. With respect to Reply, the reply-to-all option will exclude addresses
  4298. listed here.
  4299.  
  4300. <End of help on this topic>
  4301. ====== h_config_abook_formats =====
  4302.         OPTION: Addressbook-Formats
  4303.  
  4304. This option specifies the format that address books are displayed in.
  4305. Normally, address books are displayed with the nicknames in the first
  4306. column, the fullnames in the second column, and addresses in the third
  4307. column.  The system figures out reasonable defaults for the widths of
  4308. the columns.  An address book may be given a different format by
  4309. listing special tokens in the order you want them to display.  The
  4310. possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT.
  4311. So, for example, to get the default behavior you could list
  4312.  
  4313. addressbook-formats=NICKNAME FULLNAME ADDRESS
  4314.  
  4315. (You can also use the token DEFAULT to get the default behavior for
  4316. an address book format.)
  4317.  
  4318. The tokens are separated by spaces.  \"Addressbook-formats\" is a list,
  4319. so if you have more than one address book you may have a separate format
  4320. for each by putting its format at the corresponding location in the
  4321. \"addressbook-formats\" list.  Listed first are the personal address books,
  4322. then the global address books.  So, if you have two personal address
  4323. books and one global address book, you may have up to three formats in
  4324. the \"addressbook-formats\" list.  If \"addressbook-formats\" doesn't
  4325. have as many elements as there are address books, the last element is
  4326. used repeatedly.  Each of the tokens may also be optionally followed
  4327. by parentheses with either a number or a percentage inside the parentheses.
  4328. For example, FULLNAME(13) means to allocate 13 characters of space to
  4329. the fullnames column, FULLNAME(20%) means to allocate 20% of the
  4330. available space (the screen width minus the space for inter-column spaces)
  4331. to the fullnames column, while plain FULLNAME means the system will
  4332. attempt to figure out a reasonable number of columns.  There are
  4333. always 2 spaces between every column, so if you use fixed column
  4334. widths (like 13) you should remember to take that into account.
  4335.  
  4336. <End of help on this topic>
  4337. ====== h_config_index_format =====
  4338.         OPTION: Index-Format
  4339.  
  4340. This option specifies the format that folder indexes are displayed in.
  4341. Normally, the system figures out reasonable defaults for the widths of
  4342. the columns of the index display.  A non-standard display format can be
  4343. used by listing special tokens in the order you want them to display.  The
  4344. tokens are STATUS, FULLSTATUS, MSGNO, DATE, SIZE, DESCRIPSIZE, SUBJECT,
  4345. FROMORTO, FROM, and TO.  The tokens are separated by spaces.
  4346. Each of the tokens may also be optionally followed by parentheses with
  4347. either a number or a percentage inside the parentheses.  For example,
  4348. SUBJECT(13) means to allocate 13 characters of space to the subject
  4349. column, SUBJECT(20%) means to allocate 20% of the available space to
  4350. the subjects column, while plain SUBJECT means the system will attempt
  4351. to figure out a reasonable amount of space.  There is always one space
  4352. between every column, so if you use fixed column widths (like 13) you
  4353. should remember to take that into account.  Several of the fields are
  4354. virtually fixed-width, so it doesn't make much sense to specify the width
  4355. for them.  The fields STATUS, FULLSTATUS, MSGNO, DATE, SIZE, and DESCRIPSIZE
  4356. all fall into that category.  You *may* specify widths for those if you
  4357. wish, but you're probably better off letting the system pick those widths.
  4358. FROMORTO just means it will list the From address unless it is you, in
  4359. which case it will list the TO address.  The default is equivalent to:
  4360.  
  4361. index-format=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJECT(67%)
  4362.  
  4363. This means that the four fields without percentages will be allocated
  4364. first, and then 33% and 67% of the *remaining* space will go to the from
  4365. and subject fields.  If one of those two fields is specified as a percentage
  4366. and the other is left for the system to choose, then the percentage is
  4367. taken as an absolute percentage of the screen, not of the space remaining
  4368. after allocating the first four columns.  It doesn't usually
  4369. make sense to do it that way.  If you leave off all the widths, then the
  4370. subject and from fields (if both are present) are allocated space in a
  4371. 2 to 1 ratio, which is almost exactly the same as the default.
  4372.  
  4373. The token FROM is like FROMORTO, except that it always shows the From
  4374. address, even if it is you.  TO always shows the first address from the
  4375. TO line, or the first newsgroup if there is no To.  SENDER can be used
  4376. to show the Sender of the message, as opposed to what is in the From line.
  4377.  
  4378. STATUS is three characters wide, with the first column showing '*' for
  4379. messages marked Important, or '+' for messages addressed to you, or
  4380. nothing.  The second column is blank (and is sometimes used for the
  4381. cursor) and the third column shows the letter 'D' if the message is
  4382. deleted, or 'A' if it is answered (but not deleted), or 'N' if it is
  4383. new (but not deleted or answered).  FULLSTATUS is an alternate form of
  4384. the STATUS field.  It is six characters wide.  The first column is '+'
  4385. or blank, the third column is '*' or blank, the fourth column is 'N' or
  4386. blank, the fifth column is 'A' or blank, and the sixth column is 'D' or
  4387. blank.
  4388.  
  4389. DESCRIPSIZE is intended to be a more useful description of the message
  4390. than just its size in bytes, but it isn't very useful at this point.  The
  4391. plus sign in the DESCRIPSIZE view means there are attachments.
  4392.  
  4393. What you are most likely to do with this configuration option is to
  4394. specify which fields appear at all, which order they appear in, and the
  4395. percentage of screen that is used for the from and subject fields if you
  4396. don't like the 2 to 1 default.
  4397.  
  4398. <End of help on this topic>
  4399. ====== h_config_composer_wrap_column =====
  4400.         OPTION: Composer-Wrap-Column
  4401.  
  4402. This option specifies an aspect of Pine's Composer.  This gives the
  4403. maximum width that auto-wrapped lines will have.  It's also the maximum
  4404. width of lines justified using the ^J Justify command.  The normal default
  4405. is \"74\".  The largest allowed setting is normally \"80\" in order to
  4406. prevent very long lines from being sent in outgoing mail.  When the mail
  4407. is actually sent, trailing spaces will be stripped off of each line.
  4408.  
  4409. <End of help on this topic>
  4410. ====== h_config_viewer_overlap =====
  4411.         OPTION: Viewer-Overlap
  4412.  
  4413. This option specifies an aspect of Pine's Message Viewing screen.  When
  4414. the space bar is used to page forward in a message, the number of lines
  4415. specified by the \"viewer-overlap\" variable will be repeated from the
  4416. bottom of the screen.  That is, if this was set to two lines, then the
  4417. bottom two lines of the screen would be repeated on the top of the next
  4418. screen.  The normal default value is \"2\".
  4419.  
  4420. <End of help on this topic>
  4421. ====== h_config_scroll_margin =====
  4422.         OPTION: Scroll-margin
  4423.  
  4424. This option controls when Pine's line-by-line scrolling occurs.
  4425. Typically, when a selected item is at the top or bottom screen edge
  4426. and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the
  4427. displayed items are scrolled down or up by a single line.
  4428.  
  4429. This option allows you to tell Pine the number of lines from the top and
  4430. bottom screen edge that line-by-line paging should occcur.  For example,
  4431. setting this value to one (1) will cause Pine to scroll the display
  4432. vertically when you move to select an item on the display's top or
  4433. bottom edge.
  4434.  
  4435. By default, this variable is zero, indicating that scrolling happens
  4436. when you move up or down to select an item immediately off the display's
  4437. top or bottom edge.
  4438.  
  4439. <End of help on this topic>
  4440. ====== h_config_reply_indent_string =====
  4441.         OPTION: Reply-Indent-String
  4442.  
  4443. This variable specifies an aspect of Pine's Reply command.  When a message
  4444. is replied to and the text of the message is included, that text
  4445. usually has the string \"> \" prepended to each line to indicate quoting.
  4446.  
  4447. This variable specifies a different value for that string.  If you wish to
  4448. use a string which begins or ends with a space, enclose the string in double
  4449. quotes.
  4450.  
  4451. You can also include the sender's name in the prepended string.  The first
  4452. occurrence of \"_FROM_\" in the reply-indent-string will be replaced with
  4453. the \"username\" portion of the address being replied to.
  4454.  
  4455. The normal default is \"> \".
  4456.  
  4457. <End of help on this topic>
  4458. ====== h_config_empty_hdr_msg =====
  4459.         OPTION: Empty-Header-Message
  4460.  
  4461. When sending, if all of the To, Cc, and Newsgroups fields are empty,
  4462. Pine will put a special address in the To line.  The default value is
  4463. \"Undisclosed recipients: ;\".  The reason for this is to avoid
  4464. embarrassment caused by some Internet mail transfer software that
  4465. interprets a \"missing\" To: header as an error and replaces it with an
  4466. Apparently-to: header that may contain the addresses you entered on the
  4467. Bcc: line, defeating the purpose of the Bcc.  You may change the part
  4468. of this message that comes before the \": ;\" by setting the
  4469. \"Empty-Header-Message\" variable to something else.
  4470.  
  4471. The normal default is \"Undisclosed recipients\".
  4472.  
  4473. <End of help on this topic>
  4474. ====== h_config_status_msg_delay =====
  4475.         Experimental OPTION: Status-Message-Delay
  4476.  
  4477. If this is set to a positive number, it causes the cursor to move to the
  4478. status line whenever a status message is printed and pause there for this
  4479. many seconds.  It will probably only be useful if the show-cursor feature
  4480. is also turned on.
  4481.  
  4482. <End of help on this topic>
  4483. ====== h_config_mailcheck =====
  4484.         OPTION: Mail-Check-Interval
  4485.  
  4486. This options specifies, in seconds, how often Pine will check for new
  4487. mail.  If set to zero, new-mail checking is disabled.  There is a minimum
  4488. value, normally 15 seconds.
  4489.  
  4490. <End of help on this topic>
  4491. ====== h_config_news_active =====
  4492.         OPTION: News-Active-File-Path
  4493.  
  4494. This option tells Pine where to look for the \"active file\" for newsgroups
  4495. when accessing news locally, rather than via NNTP.  The default path is
  4496. usually \"/usr/lib/news/active\".
  4497.  
  4498. <End of help on this topic>
  4499. ====== h_config_news_spool =====
  4500.         OPTION: News-Spool-Directory
  4501.  
  4502. This option tells Pine where to look for the \"news spool\" for newsgroups
  4503. when accessing news locally, rather than via NNTP.  The default path is
  4504. usually \"/usr/spool/news\".
  4505.  
  4506. <End of help on this topic>
  4507. ====== h_config_image_viewer =====
  4508.         OPTION: Image-Viewer
  4509.  
  4510. This option specifies the program Pine should call to view MIME
  4511. attachments of type IMAGE (e.g. GIF or TIFF).  The Image Viewer setting is
  4512. no longer needed, but remains for backward compatibility.  The more
  4513. general method for associating external printing and viewing programs with
  4514. specific MIME data types is to use the system's (or your personal)
  4515. \"mailcap\" configuration file.
  4516.  
  4517. <End of help on this topic>
  4518. ====== h_config_domain_name =====
  4519.         OPTION: Use-Only-Domain-Name
  4520.  
  4521. This option is used only if the \"user-domain\" option is *not* set.  If set
  4522. to \"Yes\" (and user-domain is not used), then Pine strips the hostname from
  4523. your return (\"From\") address and when completing unqualified addresses
  4524. that you enter into the composer.
  4525.  
  4526. If you set this, see also the \"quell-user-lookup-in-passwd-file\" feature.
  4527.  
  4528. This option is not applicable to PC-Pine.
  4529.  
  4530. <End of help on this topic>
  4531. ====== h_config_prune_date =====
  4532.         OPTION: Last-Time-Prune Question
  4533.  
  4534. This value records the last time you were asked about deleting old
  4535. sent-mail. It is set automatically by Pine at the beginning of each
  4536. month. If you wish to suppress the monthly sent-mail pruning feature, set
  4537. this to a date in the future, e.g. 99.12
  4538.  
  4539. <End of help on this topic>
  4540. ====== h_config_goto_default =====
  4541.         OPTION: goto-default-rule
  4542.  
  4543. This value affects Pine's behavior when you use the Goto command.
  4544. Pine's usual behavior has two parts.  If your current folder is \"Inbox\",
  4545. Pine will offer the last open folder as the default.  If the current
  4546. folder is other than \"Inbox\", \"Inbox\" is offered as the default.
  4547.  
  4548. There are three possible values for this option.  The default just
  4549. described:
  4550.  
  4551.         inbox-or-folder-in-recent-collection
  4552.  
  4553. The second accepted value is a variation on the default which again
  4554. offers \"Inbox\" if it isn't currently open, but otherwise offers the
  4555. most recent folder in the first collection found in the \"FOLDER LIST\"
  4556. screen.  It's called:
  4557.  
  4558.         inbox-or-folder-in-first-collection
  4559.  
  4560. The last accepted value simply causes the most recently opened folder
  4561. to be offered as the default regardless of the currently opened folder.
  4562. It's called:
  4563.  
  4564.         most-recent-folder
  4565.  
  4566. NOTE: The default while a newsgroup is open remains the same; the last
  4567. open newsgroup.
  4568.  
  4569. <End of help on this topic>
  4570. ====== h_config_enable_full_hdr =====
  4571.         FEATURE: enable-full-header-cmd
  4572.  
  4573. This feature enables the \"H Full Headers\" command which toggles between
  4574. the display of all headers in the message and the normal edited view of
  4575. headers.  The Full Header command also controls which headers are included
  4576. for Export, Pipe, Print, Forward, and Reply functions.  (For Reply, the
  4577. Full Header mode will respect the \"include-headers-in-reply\" feature
  4578. setting.)
  4579.  
  4580. <End of help on this topic>
  4581. ====== h_config_enable_pipe =====
  4582.         FEATURE: enable-unix-pipe-cmd
  4583.  
  4584. This feature enables the \"| Pipe\" command that sends the current message
  4585. to the specified Unix command for external processing.  Not available on
  4586. PC-Pine.
  4587.  
  4588. <End of help on this topic>
  4589. ====== h_config_enable_tab_complete =====
  4590.         FEATURE: enable-tab-completion
  4591.  
  4592. This feature enables the TAB key when at a prompt for a filename. In this
  4593. case, TAB will cause the partial name already entered to be automatically
  4594. completed, provided the partial name is unambiguous.
  4595.  
  4596. <End of help on this topic>
  4597. ====== h_config_quit_wo_confirm =====
  4598.          FEATURE: quit-without-confirm
  4599.  
  4600. This feature controls whether or not Pine will ask for confirmation when a
  4601. Quit command is received.
  4602.  
  4603. <End of help on this topic>
  4604. ====== h_config_enable_jump =====
  4605.          FEATURE: enable-jump-shortcut
  4606.  
  4607. Setting this feature will allow you to enter a number (followed by RETURN)
  4608. and jump to that message number, when in the FOLDER INDEX or MESSAGE TEXT
  4609. screens.  In other words, it obviates the need for typing the \"J\" for the
  4610. Jump command.
  4611.  
  4612. <End of help on this topic>
  4613. ====== h_config_enable_alt_ed =====
  4614.         FEATURE: enable-alternate-editor-cmd
  4615.  
  4616. If this feature is set, and the \"editor\" variable is not set, entering
  4617. the ^_ (Control-underscore) key while composing a message will prompt you
  4618. for the name of the editor you would like to use.
  4619.  
  4620. If the environment variable $EDITOR is set, this value will be offered as
  4621. a default.
  4622.  
  4623. If \"editor\" variable is set, the ^_ key will activate the specified
  4624. editor without prompting, in which case it is not necessary to
  4625. set the \"enable-alternate-editor-cmd\" feature.  This feature is not
  4626. available in PC-Pine.
  4627.  
  4628. <End of help on this topic>
  4629. ====== h_config_alt_ed_now =====
  4630.          FEATURE: enable-alternate-editor-implicitly
  4631.  
  4632. If this feature and the \"editor\" variable are both set, Pine will
  4633. automatically activate the specified editor when the cursor is moved from
  4634. the header of the message being composed into the message text.  For
  4635. replies, the alternate editor will be activated immediately.  If this
  4636. feature is set but the \"editor\" variable is not set, then Pine will
  4637. automatically ask for the name of an alternate editor when the cursor
  4638. is moved out of the header being composed, or if a reply is being done.
  4639. This feature is not available in PC-Pine.
  4640.  
  4641. <End of help on this topic>
  4642. ====== h_config_enable_bounce =====
  4643.          FEATURE: enable-bounce-cmd
  4644.  
  4645. Setting this feature enables the \"B Bounce\" command, which will prompt
  4646. for an address and *remail* the message to the new recipient.  This command
  4647. is used to re-direct messages that you have received in error, or need to
  4648. be redirected for some other reason (e.g. list moderation).  The final
  4649. recipient will see a header indicating that you have Resent the msg, but
  4650. the message's From: header will show the original author of the message,
  4651. and replies to it will go back to that author, and not to you.
  4652.  
  4653. <End of help on this topic>
  4654. ====== h_config_enable_agg_ops =====
  4655.          FEATURE: enable-aggregate-command-set
  4656.  
  4657. Setting this feature enables the commands and subcommands that relate to
  4658. performing operations on more than one message at a time.  We call these
  4659. \"aggregate operations\".  In particular, the \"; Select\", \"A Apply\",
  4660. and \"Z Zoom\" commands are enabled by this feature.  Select is used to
  4661. \"tag\" one or more messages meeting the specified criteria.  Apply can
  4662. then be used to apply any message command to all of the selected/tagged
  4663. messages.  Further, the Zoom command allows you to toggle the Folder Index
  4664. view between just those Selected and all messages in the folder.
  4665.  
  4666. This feature also enables the \"^X\" subcommand in the FOLDER INDEX WhereIs
  4667. command which causes all messages matching the WhereIs argument to become
  4668. selected.
  4669.  
  4670. <End of help on this topic>
  4671. ====== h_config_enable_flag =====
  4672.          FEATURE: enable-flag-cmd
  4673.  
  4674. Setting this feature enables the \"* Flag\" command which allows you to
  4675. manipulate the status flags associated with a message.  By default, Flag
  4676. will set the \"Important\" flag, which results in an asterisk being
  4677. displayed in column one of the FOLDER INDEX for such messages.
  4678.  
  4679. <End of help on this topic>
  4680. ====== h_config_flag_screen_default =====
  4681.          FEATURE: enable-flag-screen-implicitly
  4682.  
  4683. The feature modifies the behavior of the \"* Flag\" command (provided it
  4684. too is enabled).  By default, when the \"* Flag\" command is selected,
  4685. Pine offers a prompt to set one of several flags and also offers the
  4686. option of entering the detailed flag manipulation screen via the \"^T\"
  4687. key. Enabling this feature causes Pine to immediately enter the detailed
  4688. flag screen rather than first offer the simple prompt.
  4689.  
  4690. <End of help on this topic>
  4691. ====== h_config_can_suspend =====
  4692.          FEATURE: enable-suspend
  4693.  
  4694. Setting this feature will allow you to type ^Z (Control Z) and temporarily
  4695. suspend Pine.  Not available on PC-Pine.
  4696.  
  4697. <End of help on this topic>
  4698. ====== h_config_expanded_folders =====
  4699.          FEATURE: expanded-view-of-folders
  4700.  
  4701. If multiple folder collections are defined, and you wish to have them all
  4702. expanded implicitly upon entering the FOLDER LIST screen, then set this
  4703. feature.
  4704.  
  4705. <End of help on this topic>
  4706. ====== h_config_expanded_addrbooks ======
  4707.          FEATURE: expanded-view-of-addressbooks
  4708.  
  4709. If multiple address books (either personal or global) are defined, and you
  4710. wish to have them all expanded implicitly upon entering the ADDRESS BOOK
  4711. screen, then set this feature.
  4712.  
  4713. <End of help on this topic>
  4714. ====== h_config_print_from ======
  4715.          FEATURE: print-includes-from-line
  4716.  
  4717. If this feature is set, then the Berkeley-mail style From line is included
  4718. at the start of each message that is printed.  This line looks something
  4719. like the following, with the address replaced by the address from the
  4720. From line of the message being printed:
  4721.  
  4722.    From user@domain.somewhere.com Mon May 13 14:11:06 1996
  4723.  
  4724. <End of help on this topic>
  4725. ====== h_config_expanded_distlists ======
  4726.          FEATURE: expanded-view-of-distribution-lists
  4727.  
  4728. If this feature is set, then distribution lists in the address book
  4729. screen will be expanded automatically.
  4730.  
  4731. <End of help on this topic>
  4732. ====== h_config_compose_news_wo_conf ======
  4733.          FEATURE: compose-sets-newsgroup-without-confirm
  4734.  
  4735. This feature controls one aspect of Pine's Composer.  If you enter the
  4736. composer while reading a news group, you will normally be prompted to
  4737. determine whether you intend the new message to be posted to the current
  4738. newsgroup or not.  If this feature is set, Pine will not prompt you
  4739. in this situation, and will assume that you do indeed wish to post
  4740. to the newsgroup you are reading.
  4741.  
  4742. <End of help on this topic>
  4743. ====== h_config_compose_rejects_unqual ======
  4744.      FEATURE: compose-rejects-unqualified-addrs
  4745.  
  4746. This feature controls one aspect of the message composer; in particular,
  4747. what happens when an unqualified name is entered into an address header.
  4748. If set, unqualified names entered as addresses will be treated as errors
  4749. unless they match an addressbook nickname.  Pine will not attempt to turn
  4750. them into complete addresses by adding your local domain.
  4751.  
  4752. A complete (fully qualified) address is one containing a username followed
  4753. by an \"@\" symbol, followed by a host or domain name (e.g.
  4754. \"jsmith@nowhere.edu\").  An unqualified name is one *without* the \"@\"
  4755. symbol and host or domain name (e.g. \"jsmith\"),
  4756.  
  4757. When you enter a fully qualified address, Pine does not interpret or
  4758. modify it, but simply passes it on to the mail-transport-agent (MTA) for
  4759. your system.  Pine conforms to the Internet standards governing message
  4760. headers and will not send an unqualifed name to the MTA.  Therefore, when
  4761. you enter an unqualified name, Pine will normally attempt to turn it into
  4762. a fully qualified address, first by checking to see if you have entered a
  4763. matching nickname in your addressbook, or failing that, by simply adding
  4764. your own domain to the name entered.  So if your address is
  4765. \"jsmith@nowhere.edu\" and you enter \"fred\", then (assuming \"fred\" is
  4766. not a valid nickname), Pine will turn that into \"fred@nowhere.edu\".
  4767.  
  4768. There are situations where it is not desirable for Pine to interpret such
  4769. unqualified names as valid (local) addresses.  For example, if \"fred\"
  4770. turned out to be a typo (intended to be an addressbook nickname), but
  4771. there actually was a \"fred\" in your local domain, the message might be
  4772. mis-delivered without your realizing it.  In order to reduce the likelihood
  4773. of such accidents, setting this feature will cause Pine to treat such
  4774. addresses as errors, and require that you explicitly enter the full local
  4775. address (e.g. \"fred@nowhere.edu\") or correct the name so that it matches
  4776. an address book nickname.
  4777.  
  4778. Consider this a safety feature against mis-directed mail.
  4779.  
  4780. <End of help on this topic>
  4781. ====== h_config_quell_local_lookup  ======
  4782.          FEATURE: quell-user-lookup-in-passwd-file
  4783.  
  4784. This feature controls an aspect of Pine's Composer, and if needed, will
  4785. usually be set by your system manager in Pine's system-wide configuration
  4786. file. Specifically, if this feature is set, Pine will not attempt to look
  4787. in the system password file to find a Full Name for the entered address.
  4788.  
  4789. Normally, names you enter into address fields (e.g. To: or Cc:) are
  4790. checked against your address book(s) to see if they match an address book
  4791. nickname.  Failing that, (in Unix Pine) the name is then checked against
  4792. the Unix password file.  If the entered name matches a username in the
  4793. system password file, Pine extracts the corresponding Full Name information
  4794. for that individual, and adds that to the address being entered.
  4795.  
  4796. However, password file matching can have surprising (incorrect) results if
  4797. other users of the system do not receive mail at the domain you are using.
  4798. That is, if either the \"user-domain\" or \"use-only-domain-name\" option
  4799. is set such that the administrative domain of other users on the system
  4800. isn't accurately reflected, Pine should be told that a passwd file match
  4801. is coincidental, and Full Name info will be incorrect.  For example, a
  4802. personal name from the password file could get falsely paired with the
  4803. entered name as it is turned into an address in the configured domain.
  4804.  
  4805. If you are seeing this behavior, enabling this feature will prevent Unix
  4806. Pine from looking up names in the password file to find the Full Name
  4807. for incomplete addresses you enter.
  4808.  
  4809. <End of help on this topic>
  4810. ====== h_config_preserve_start_stop ======
  4811.          FEATURE: preserve-start-stop-characters
  4812.  
  4813. This feature controls how special control key characters, typically
  4814. Ctrl-S and Ctrl-Q, are interpreted when input to Pine.  These characters
  4815. are known as the \"start\" and \"stop\" characters and are sometimes used in
  4816. communications paths to control data flow between devices that operate at
  4817. different speeds.
  4818.  
  4819. By default, Pine turns the system's handling of these special characters
  4820. off except during printing.  However, if you see Pine reporting input errors
  4821. such as:
  4822.  
  4823.             [ Command \"^Q\" not defined for this screen. ]
  4824.  
  4825. and, at the same time, see your display become garbled, then it is likely
  4826. that setting this option will solve the problem.  Be aware, though, that
  4827. enabling this feature will also cause Pine to ostensibly \"hang\" 
  4828. whenever the Ctrl-S key combination is entered as the system is now
  4829. interpreting such input as a \"stop output\" command.  To \"start
  4830. output\"  again, simply type Ctrl-Q. 
  4831.  
  4832. <End of help on this topic>
  4833. ====== h_config_enable_incoming ======
  4834.          FEATURE: enable-incoming-folders
  4835.  
  4836. If set, this feature defines a pseudo-folder collection called
  4837. \"INCOMING MESSAGE FOLDERS\".  Initially, the only folder included
  4838. in this collection will be your INBOX, which will no longer show up in
  4839. your default saved-message folder collection.
  4840.  
  4841. You may add more folders to the Incoming Message Folders collection by
  4842. using the \"{F10:A} Add\" command in the FOLDER LIST screen.  You will
  4843. be prompted for the host the folder is stored on (which defaults to the
  4844. same host used for your INBOX), a nickname, and the actual folder name.
  4845. Once a set of Incoming Message Folders are defined, the TAB key (in
  4846. FOLDER INDEX or MESSAGE TEXT screens) may be used to scan the folders
  4847. for those with Recent messages.
  4848.  
  4849. NOTE: Pine does not do \"delivery filtering\"; this is the province of
  4850. other programs such as \"filter\" or \"procmail\".  Pine's Incoming
  4851. Message Folders collection provides a convenient way to access multiple
  4852. incoming folders, once they are created by other programs.  It is also
  4853. useful if you have accounts on multiple computers.
  4854.  
  4855. <End of help on this topic>
  4856. ====== h_config_attach_in_reply ======
  4857.          FEATURE: include-attachments-in-reply
  4858.  
  4859. This feature controls an aspect of Pine's Reply command. If set, any MIME
  4860. attachments that were part of the original message will automatically be
  4861. included in the Reply.
  4862.  
  4863. <End of help on this topic>
  4864. ====== h_config_include_header =====
  4865.          FEATURE: include-header-in-reply
  4866.  
  4867. This feature controls an aspect of Pine's Reply command. If set, and the
  4868. original message is being included in the reply, then headers from that
  4869. message will also be part of the reply.
  4870.  
  4871. <End of help on this topic>
  4872. ====== h_config_sig_at_bottom =====
  4873.         FEATURE: signature-at-bottom
  4874.  
  4875. This feature controls an aspect of Pine's Reply command.  If this feature
  4876. is set, and the original message is being included in the reply, then the
  4877. contents of your signature file (if any) will be inserted after the included
  4878. message, and the cursor will also be positioned after the included text.
  4879.  
  4880. <End of help on this topic>
  4881. ====== h_config_use_sender_not_x =====
  4882.         FEATURE: use-sender-not-X-Sender
  4883.  
  4884. Normally Pine adds a header line labeled X-Sender, if the sender is
  4885. different from the From: line.  The standard specifies that this header
  4886. line should be labeled Sender, not X-Sender.  Setting this feature causes
  4887. Sender to be used instead of X-Sender.
  4888.  
  4889. <End of help on this topic>
  4890. ====== h_config_use_fk =====
  4891.         FEATURE: use-function-keys
  4892.  
  4893. This feature specifies that Pine will respond to function keys instead of
  4894. the normal single-letter commands. In this mode, the key menus at the
  4895. bottom of each screen will show function key designations instead of the
  4896. normal mnemonic key.
  4897.  
  4898. <End of help on this topic>
  4899. ====== h_config_compose_maps_del =====
  4900.         FEATURE: compose-maps-delete-key-to-ctrl-d
  4901.  
  4902. This feature affects the behavior of the DELETE key.
  4903. If set, Delete will be equivalent to Control-D, and delete
  4904. the current character.  Normally Pine defines the Delete key
  4905. to be equivalent to Control-H, which deletes the *previous*
  4906. character.
  4907.  
  4908. <End of help on this topic>
  4909. ====== h_config_compose_bg_post =====
  4910.         FEATURE: enable-background-sending
  4911.  
  4912. This feature affects the behavior of Pine's mail sending.  If set, this
  4913. feature enables a subcommand in the composer's \"Send?\" confirmation
  4914. prompt.  The subcommand allows you to tell Pine to handle the actual
  4915. posting in the background.  While this feature usually allows posting
  4916. to appear to happen very fast, it has no affect on the actual delivery
  4917. time it takes a message to arrive at its destination.
  4918.  
  4919. NOTE 1: This feature isn't supported on all systems.  All DOS and Windows,
  4920.         as well as several Unix ports, do not recognize this feature.
  4921.  
  4922. NOTE 2: Error handling is significantly different when this feature is
  4923.         enabled.  Any message posting failure results in the message
  4924.         being appended to your \"Interrupted\" mail folder.  When you
  4925.         type the \"Compose\" command, Pine will notice this folder and
  4926.         offer to extract any messages contained.  Upon continuing a 
  4927.         failed message, Pine will display the nature of the failure 
  4928.         in the status message line.
  4929.  
  4930. WARNING: Under extreme conditions, it is possible for message data to
  4931.          get lost.  Do not enable this feature if you typically run close
  4932.          to any sort of disk-space limits or quotas.
  4933.  
  4934. <End of help on this topic>
  4935. ====== h_config_auto_zoom =====
  4936.         FEATURE: auto-zoom-after-select
  4937.  
  4938. This feature affects the behavior of the Select command.
  4939. If set, the select command will automatically perform a zoom
  4940. after the select is complete.
  4941.  
  4942. <End of help on this topic>
  4943. ====== h_config_auto_unzoom =====
  4944.         FEATURE: auto-unzoom-after-apply
  4945.  
  4946. This feature affects the behavior of the Apply command.  If set, and if
  4947. you are currently looking at a Zoomed Index view of selected messages,
  4948. the Apply command will do the operation you specify, but then will
  4949. implicitly do an \"UnZoom\", so that you will automatically be back in
  4950. the normal Index view after the Apply. 
  4951.  
  4952. <End of help on this topic>
  4953. ====== h_config_del_from_dot =====
  4954.         FEATURE: compose-cut-from-cursor
  4955.  
  4956. This feature controls the behavior of the Control-K command in the composer.
  4957. If set, ^K will cut from the current cursor position to the end of the line,
  4958. rather than cutting the entire line.
  4959.  
  4960. <End of help on this topic>
  4961. ====== h_config_print_index =====
  4962.         FEATURE: print-index-enabled
  4963.  
  4964. This feature controls the behavior of the Print command when in the
  4965. Folder Index screen.  If set, the print command will give you a prompt
  4966. asking if you wish to print the message index, or the currently selected
  4967. message.
  4968.  
  4969. <End of help on this topic>
  4970. ====== h_config_allow_talk =====
  4971.         FEATURE: allow-talk
  4972.  
  4973. By default, permission for others to \"talk\" to your terminal is turned
  4974. off when you are running Pine.  When this feature is set, permission is
  4975. instead turned on.  If enabled, you may see unexpected messages in the
  4976. middle of your Pine screen from someone attempting to contact you via the
  4977. \"talk\" program.
  4978.  
  4979. Note: The \"talk\" program has nothing to do with Pine or email.  The 
  4980. talk daemon on your system will attempt to print a message on your screen 
  4981. when someone else is trying to contact you.  If you wish to see these
  4982. messages while you are running Pine, you should enable this feature.
  4983.  
  4984. If you do enable this feature and see a \"talk\" message, you must 
  4985. suspend or quit Pine before you can respond.
  4986.  
  4987. <End of help on this topic>
  4988. ====== h_config_send_filter_dflt =====
  4989.         FEATURE: compose-send-offers-first-filter
  4990.  
  4991. If you have sending-filters configured, setting this feature will cause
  4992. the first filter in the sending-filters list to be offered as the default
  4993. instead of unfiltered, the usual default.
  4994.  
  4995. <End of help on this topic>
  4996. ====== h_config_custom_print =====
  4997.         FEATURE: print-offers-custom-cmd-prompt
  4998.  
  4999. When this feature is set, the print command will have an additional
  5000. subcommand called \"C CustomPrint\".  If selected, you will have
  5001. the opportunity to enter any system print command --instead of being 
  5002. restricted to using those that have been previously configured in the 
  5003. printer setup menu.
  5004.  
  5005. <End of help on this topic>
  5006. ====== h_config_enable_dot_files =====
  5007.         FEATURE: enable-dot-files
  5008.  
  5009. When this feature is set, files beginning with dot (\".\") will be
  5010. visible in the file browser.  For example, you'll be able to select them
  5011. when using the browser to add an attachment to a message.
  5012.  
  5013. <End of help on this topic>
  5014. ====== h_config_enable_dot_folders =====
  5015.         FEATURE: enable-dot-folders
  5016.  
  5017. When this feature is set, folders beginning with dot (\".\") may be added
  5018. and viewed.
  5019.  
  5020. <End of help on this topic>
  5021. ====== h_config_ff_between_msgs =====
  5022.         FEATURE: print-formfeed-between-messages
  5023.  
  5024. Setting this feature causes a formfeed to be printed between messages when
  5025. printing multiple messages (with Apply prYnt command).
  5026.  
  5027. <End of help on this topic>
  5028. ====== h_config_blank_keymenu =====
  5029.         FEATURE: disable-keymenu
  5030.  
  5031. If this feature is set the command key menu that normally appears on the
  5032. bottom two lines of the screen will not usually be there.  Asking for
  5033. help with ^G or ? will cause the key menu to appear instead of causing
  5034. the help message to come up.  If you want to actually see the help text,
  5035. another ^G or ? will show it to you.  After the key menu has popped
  5036. up with the help key it will remain there for an O for Other command but
  5037. disappear if any other command is typed.
  5038.  
  5039. <End of help on this topic>
  5040. ====== h_config_enable_mouse =====
  5041.         FEATURE: enable-mouse-in-xterm
  5042.  
  5043. This feature controls whether or not an X terminal mouse can be used with
  5044. Pine.  If set, and the $DISPLAY variable indicates that an X terminal is
  5045. being used, the left mouse button on the mouse can be used to select text
  5046. or commands.
  5047.  
  5048. Note: if this feature is set, the behavior of X terminal cut-and-paste is
  5049. also modified.  It is necessary to hold the shift key down while clicking
  5050. left or middle mouse buttons for the normal xterm cut/paste operations. 
  5051.  
  5052. <End of help on this topic>
  5053. ====== h_config_enable_xterm_newmail =====
  5054.         FEATURE: enable-newmail-in-xterm-icon
  5055.  
  5056. This feature controls whether or not Pine will attempt to announce new
  5057. mail arrival when it is running in an X terminal window and that window
  5058. is iconified.  If set, and the $DISPLAY variable indicates that an X
  5059. terminal is being used, Pine will send appropriate escape sequences to
  5060. the X terminal to modify the label on Pine's icon to indicate that new
  5061. mail has arrived. 
  5062.  
  5063. <End of help on this topic>
  5064. ====== h_config_pass_control =====
  5065.         FEATURE: pass-control-characters-as-is
  5066.  
  5067. This feature controls how certain characters contained in messages are
  5068. displayed.  If set, all characters in a message will be sent to the
  5069. screen.  Normally, control characters are automatically suppressed in
  5070. order to avoid inadvertently changing terminal setup parameters.
  5071.  
  5072. <End of help on this topic>
  5073. ====== h_config_fcc_on_bounce =====
  5074.         FEATURE: fcc-on-bounce
  5075.  
  5076. This feature controls an aspect of Pine's behavior when bouncing a
  5077. message. If set, normal FCC (\"File Carbon Copy\") processing will be
  5078. done, just as if you had composed a message to the address you are
  5079. bouncing to.  If not set, no FCC of the message will be saved. 
  5080.  
  5081. <End of help on this topic>
  5082. ====== h_config_show_cursor =====
  5083.         FEATURE: show-cursor
  5084.  
  5085. This feature controls an aspect of Pine's displays.  If set, the system
  5086. cursor will move to convenient locations in the displays.  For example,
  5087. to the beginning of the status field of the highlighted index line, or
  5088. to the highlighted word after a successful WhereIs command.
  5089.  
  5090. <End of help on this topic>
  5091. ====== h_config_vert_list =====
  5092.         FEATURE: single-column-folder-list
  5093.  
  5094. This feature controls an aspect of Pine's folder list screen.  If set,
  5095. the folders will be listed one per line instead of several per line
  5096. in the folder list display.
  5097.  
  5098. <End of help on this topic>
  5099. ====== h_config_verbose_post =====
  5100.         FEATURE: enable-verbose-smtp-posting
  5101.  
  5102. This feature controls an aspect of Pine's message sending.  When enabled,
  5103. Pine will send a VERB (i.e., VERBose) command early in the posting process
  5104. intended to cause the server SMTP to provide a more detailed account of
  5105. the transaction.  This feature is typically only useful to system
  5106. administrators and other support personel as an aid in troublshooting
  5107. problems.
  5108.  
  5109. Note, this feature relies on a specific capability of the system's mail
  5110. transport agent or configured \"smtp-server\".  It is possible that this
  5111. feature will cause problems for some tranport agents, and may result in
  5112. sending failure.  In addition, as the verbose output comes from the mail
  5113. transport agent, it is likely to vary from one system to another. 
  5114.  
  5115. <End of help on this topic>
  5116. ====== h_config_auto_reply_to =====
  5117.         FEATURE: reply-always-uses-reply-to
  5118.  
  5119. This feature controls an aspect of Pine's Reply command.  If set, Pine
  5120. will not prompt when a message being replied to contains a \"Reply-To:\"
  5121. header value, but will simply use its value (as opposed to using the
  5122. \"From:\" field's value).
  5123.  
  5124. Note: Using the \"Reply-To:\" address is usually the preferred behavior,
  5125. however, some mailing list managers choose to place the list's address in
  5126. the \"Reply-To:\" field of any message sent out to the list.  In such
  5127. cases, this feature makes it all too easy for personal replies to be
  5128. inadvertently sent to the entire mail list, so be careful! 
  5129.  
  5130. <End of help on this topic>
  5131. ====== h_config_del_skips_del =====
  5132.         FEATURE: delete-skips-deleted
  5133.  
  5134. This feature controls an aspect of Pine's Delete command.  If set, this
  5135. feature will cause the Delete command to advance past other messages that
  5136. are marked deleted.  In other words, pressing \"D\" will both mark the
  5137. current message deleted and advance to the next message that is not marked
  5138. deleted.
  5139.  
  5140. <End of help on this topic>
  5141. ====== h_config_auto_expunge =====
  5142.         FEATURE: expunge-without-confirm
  5143.  
  5144. This features controls an aspect of Pine's eXpunge command.  If set, you
  5145. will not be prompted to confirm your intent before the expunge takes place.
  5146.  
  5147. <End of help on this topic>
  5148. ====== h_config_auto_read_msgs =====
  5149.         FEATURE: auto-move-read-msgs
  5150.  
  5151. This feature controls an aspect of Pine's behavior upon quitting.  If set,
  5152. and the \"read-message-folder\" variable is also set, then Pine will
  5153. automatically transfer all read messages to the designated folder and mark
  5154. them as deleted in the INBOX.  Messages in the INBOX marked with an \"N\"
  5155. (meaning New, or unseen) are not affected.
  5156.  
  5157. <End of help on this topic>
  5158. ====== h_config_read_in_newsrc_order =====
  5159.         FEATURE: news-read-in-newsrc-order
  5160.  
  5161. This feature controls the order that news groups will be presented.  If
  5162. set, they will be presented in the same order as they occur in your .newsrc
  5163. file (or \\NEWSRC file in the case of PC-Pine).  If not set, the newsgroups
  5164. will be presented in alphabetical order.
  5165.  
  5166. <End of help on this topic>
  5167. ====== h_config_post_wo_validation =====
  5168.         FEATURE: news-post-without-validation
  5169.  
  5170. This feature controls whether the NNTP server is queried as news groups
  5171. are entered for posting.  Validation over slow links (e.g. dialup using
  5172. SLIP or PPP) can cause delays.  Set this feature to eliminate such delays.
  5173.  
  5174. <End of help on this topic>
  5175. ====== h_config_select_wo_confirm =====
  5176.         FEATURE: select-without-confirm
  5177.  
  5178. This feature controls an aspect of Pine's Save, Export, and Goto commands.
  5179. These commands all take text input to specify the name of the folder or
  5180. file to be used, but allow you to press ^T for a list of possible names.
  5181. If set, the selected name will be used immediately, without further
  5182. opportunity to confirm or edit the name.
  5183.  
  5184. <End of help on this topic>
  5185. ====== h_config_use_current_dir =====
  5186.            FEATURE: use-current-dir
  5187.  
  5188. This feature controls an aspect of several commands. If set, your \"current
  5189. working directory\" will be used instead of your home directory for all of
  5190. the following operations:
  5191.  
  5192.     o Export in the FOLDER INDEX and MESSAGE TEXT screens
  5193.     o Attachment Save in the MESSAGE TEXT and ATTACHMENT TEXT screens
  5194.     o Ctrl-R file inclusion in the COMPOSER
  5195.     o Ctrl-J file attachment in the COMPOSER
  5196.  
  5197. <End of help on this topic>
  5198. ====== h_config_save_wont_delete =====
  5199.           FEATURE: save-will-not-delete
  5200.  
  5201. This feature controls one aspect of the Save command.  If set, Save will
  5202. not mark the message \"deleted\" (its default behavior) after it has been
  5203. copied to the designated folder.
  5204.  
  5205. <End of help on this topic>
  5206. ====== h_config_save_advances =====
  5207.           FEATURE: save-will-advance
  5208.  
  5209. This feature controls one aspect of the Save command.  If set, Save will
  5210. (in addition to copying the current message to the designated folder) also
  5211. advance to the next message.
  5212.  
  5213. <End of help on this topic>
  5214. ====== h_config_force_low_speed =====
  5215.           FEATURE: assume-slow-link
  5216.  
  5217. This feature affects Pine's display routines.  If set, the normal
  5218. inverse-video cursor (used to highlight the current item in a list) will be
  5219. replaced by an \"arrow\" cursor and other screen update optimizations for
  5220. low-speed links (e.g. 2400 bps dialup connections) will be activated.
  5221.  
  5222. <End of help on this topic>
  5223. ====== h_config_show_delay_cue =====
  5224.           FEATURE: enable-mail-check-cue
  5225.  
  5226. If set, this feature will cause an asterisk to appear in the upper
  5227. left-hand corner of the screen whenever Pine checks for new mail, and two
  5228. asterisks whenever Pine saves (checkpoints) the state of the current
  5229. mailbox to disk.
  5230.  
  5231. <End of help on this topic>
  5232. ====== h_config_auto_open_unread =====
  5233.           FEATURE: auto-open-next-unread
  5234.  
  5235. This feature controls the behavior of the TAB key when traversing folders
  5236. in the optional \"incoming-folders\" collection or in optional
  5237. \"news-collections\".  When the TAB (Next New) key is pressed, and there
  5238. are no more unseen messages in the current (incoming message or news)
  5239. folder, Pine will search the list of folders in the current collection for
  5240. one containing New or Recent (new since the last time the folder was
  5241. opened) messages.  Normally, when such a folder is found, Pine will ask
  5242. whether you wish to open the folder.  If this feature is set, Pine will
  5243. automatically open the folder without prompting.
  5244.  
  5245. <End of help on this topic>
  5246. ====== h_config_auto_include_reply =====
  5247.           FEATURE: include-text-in-reply
  5248.  
  5249. This feature controls an aspect of Pine's Reply command.  Normally, Pine
  5250. will ask whether you wish to include the original message in your reply.
  5251. If this feature is set, the original message will be included in the reply
  5252. automatically, without prompting.
  5253.  
  5254. <End of help on this topic>
  5255. ====== h_config_select_in_bold =====
  5256.          FEATURE: show-selected-in-boldface
  5257.  
  5258. This feature controls an aspect of Pine's aggregate operation commands; in
  5259. particular, the Select and WhereIs commands. Select and WhereIs (with the
  5260. ^X subcommand) will search the current folder for messages meeting a
  5261. specified criteria, and \"tag\" the resulting messages with an \"X\" in the
  5262. first column of the applicable lines in the FOLDER INDEX.  If this feature
  5263. is set, instead of using the \"X\" to denote a selected message, Pine will
  5264. attempt to display those index lines in boldface. Whether this is
  5265. preferable to the \"X\" will depend on personal taste and the type of
  5266. terminal being used.
  5267.  
  5268. <End of help on this topic>
  5269. ====== h_config_folder_extension ======
  5270.  
  5271. Normally PC-Pine appends the extension \"MTX\" to all local (PC) folder
  5272. names and suppresses that extension when listing those folders.  By
  5273. setting this option, you override this behavior.  In particular, you may
  5274. set \"folder-extension\" to the \"null string\" which tells PC-Pine to
  5275. neither add nor hide-from-view *any* folder name extension.
  5276.  
  5277. The reason you might wish to override the MTX default is that recent
  5278. versions of PC-Pine have the ability to open (albeit READ-ONLY) normal
  5279. Unix mail folders. Since it might be inconvenient to rename all of them to
  5280. have an MTX extension, it is possible with this option to switch PC-Pine's
  5281. behavior so that such folders can be seen and accessed without changing
  5282. their names. However, doing this means that your existing PC-Pine local
  5283. folders will have apparently changed their names.  For example, if you had
  5284. a local folder named \"FOO\" it will now appear in the Folder List as
  5285. \"FOO.MTX\". If you wish to save additional messages to that folder, you
  5286. will need to enter the full name, \"FOO.MTX\" at the Save prompt.
  5287. Likewise for GOTO.
  5288.  
  5289. If you wish to permanently avoid having to deal with folder name extensions,
  5290. you will need to set this option to the null string by entering two double-
  5291. quote marks, and you will need to rename your existing local folders to
  5292. not have the MTX extension.  In DOS this can be done in one command, once
  5293. you have changed to your mail directory:  RENAME  *.MTX  *.
  5294.  
  5295. We don't know why you might wish to, but you could also use this option
  5296. to tell PC-Pine to use an extension other than MTX.  In this case, enter
  5297. the three characters you desire to use in lieu of \"MTX\".  Note that
  5298. your existing folders will need to be renamed to correspond to this new
  5299. extension.
  5300.  
  5301.  
  5302. <End of help on this topic>
  5303. ====== h_config_disable_config_screen =====
  5304.          FEATURE: disable-config-screen
  5305.  
  5306. This feature is intended for use by system managers who wish to provide a
  5307. specific Pine configuration to their users in order to reduce confusion
  5308. about Pine's growing set of optional features.  If set, the configuration
  5309. screen (Main/Setup/Config) will not be available.
  5310.  
  5311. <End of help on this topic>
  5312. ====== h_config_disable_password_cmd =====
  5313.         FEATURE: disable-password-cmd
  5314.  
  5315. This feature is intended for use by system managers who wish to globally
  5316. disable Pine's password-changing command (Main/Setup/Password) at sites
  5317. where it is inappropriate.
  5318.  
  5319. <End of help on this topic>
  5320. ====== h_config_disable_update_cmd =====
  5321.         FEATURE: disable-update-cmd
  5322.  
  5323. This feature is intended for use by system managers who wish to globally
  5324. disable Pine's update command (Main/Setup/Update).  The Update command
  5325. allows PC-Pine users to fetch new releases of the program.  Tech notes
  5326. and other information may also be available via the Update function.
  5327.  
  5328. <End of help on this topic>
  5329. ====== h_config_disable_kblock_cmd =====
  5330.         FEATURE: disable-kblock-cmd
  5331.  
  5332. This feature is intended for use by system managers who wish to globally
  5333. disable the keyboard lock command (Main/KBlock).
  5334.  
  5335. <End of help on this topic>
  5336. ====== h_config_quote_all_froms =====
  5337.         FEATURE: save-will-quote-leading-froms
  5338.  
  5339. This feature controls an aspect of the Save command (and also the way
  5340. outgoing messages are saved to an FCC folder).  If set, Pine will add
  5341. a leading \">\" character in front of message lines beginning with \"From
  5342. \" when they are saved to another folder, including lines syntactically
  5343. distinguishable from the type of message separator line commonly used on
  5344. Unix systems.
  5345.  
  5346. The default behavior is that a \">\" will be prepended only to lines
  5347. beginning with \"From \" that might otherwise be confused with a message
  5348. separator line on Unix systems.  If pine is the only mail program you use,
  5349. this default is reasonable.  If another program you use has trouble
  5350. displaying a message with an unquoted \"From \" saved by Pine, you should
  5351. enable this feature.  This feature only applies to the common Unix mailbox
  5352. format that uses message separator lines beginning with \"From \".  If
  5353. Pine has been configured to use a different mailbox format (possibly
  5354. incompatible with other mail programs), then this issue does not arise,
  5355. and the feature is irrelevant.
  5356.  
  5357. <End of help on this topic>
  5358. ====== h_config_normal_fg =====
  5359.         OPTION: normal-foreground-color
  5360.  
  5361. Sets PC-Pine's foreground (the actual character) color.
  5362.  
  5363. <End of help on this topic>
  5364. ====== h_config_normal_bg =====
  5365.         OPTION: normal-background-color
  5366.  
  5367. Sets PC-Pine's background (the area behind the character) color.
  5368.  
  5369. <End of help on this topic>
  5370. ====== h_config_reverse_fg =====
  5371.         OPTION: reverse-foreground-color
  5372.  
  5373. Sets PC-Pine's foreground (the actual character) color for reverse video
  5374. characters.
  5375.  
  5376. <End of help on this topic>
  5377. ====== h_config_reverse_bg =====
  5378.         OPTION: reverse-background-color
  5379.  
  5380. Sets PC-Pine's background (the area behind the character) color for
  5381. reverse video characters.
  5382.  
  5383. <End of help on this topic>
  5384. ====== h_config_news_uses_recent ======
  5385.         FEATURE: news-approximates-new-status
  5386.  
  5387. This feature causes certain messages to be marked as \"New\" in the
  5388. Folder Index of news groups.
  5389.  
  5390. When opening a news group, Pine will consult your \"newsrc\" file and
  5391. determine the last message you have previously disposed of via the \"D\"
  5392. key.  If this feature is set, any subsequent messages will be shown in the
  5393. Index with an \"N\", and the first of these messages will be highlighted.
  5394. Although this is only an approximation of true \"New\" or \"unseen\"
  5395. status, it provides a useful cue to distinguish more-or-less recent
  5396. messages from those you have seen previously, but are not yet ready to
  5397. mark deleted.
  5398.  
  5399. Background: your \"newsrc\" file (used to store message status information
  5400. for news groups) is only capable of storing a single flag, and Pine uses
  5401. this to record whether or not you are \"done with\" a message, as
  5402. indicated by marking the message as \"Deleted\".  Unfortunately, this
  5403. means that Pine has no way to record exactly which messages you have
  5404. previously seen, so it normally does not show the \"N\" status flag for
  5405. any messages in a news group. This feature enables a starting
  5406. *approximation* of seen/unseen status that may be useful.
  5407.  
  5408. <End of help on this topic>
  5409. ====== h_config_suspend_spawns =====
  5410.         FEATURE: use-subshell-for-suspend
  5411.  
  5412. This feature affects Pine's behavior when process suspension is enabled
  5413. and then activated via the Ctrl-Z key.  Pine suspension allows one to
  5414. temporarily interact with the operating system command \"shell\" without
  5415. quitting Pine, and then subsequently resume the still-active Pine session.
  5416.  
  5417. When the \"enable-suspend\" feature is set and subsequently the Ctrl-Z key
  5418. is pressed, Pine will normally suspend itself and return temporary control
  5419. to Pine's parent shell process.  However, if this feature is set, Pine
  5420. will instead create an inferior subshell process.  This is useful when the
  5421. parent process is not intended to be used interactively.  Examples include
  5422. invoking Pine via the -e argument of the Unix \"xterm\" program, or via a
  5423. menu system.
  5424.  
  5425. Note that one typically resumes a suspended Pine by entering the Unix
  5426. \"fg\"  command, but if this feature is set, it will be necessary to
  5427. enter the \"exit\" command instead.
  5428.  
  5429. <End of help on this topic>
  5430. ====== h_config_8bit_smtp =====
  5431.         FEATURE: enable-8bit-to-smtp-server
  5432.  
  5433. This feature affects Pine's behavior when sending mail.  Internet standards
  5434. require that all electronic mail messages traversing the global Internet
  5435. consist of 7bit ASCII characters unless a pair of cooperating mail 
  5436. transfer agents explicitly agree to allow 8bit messages.  In general, 
  5437. then, exchanging messages in non-ASCII characters requires MIME encoding.
  5438.  
  5439. However, there are now Internet standards that allow for unencoded 8bit
  5440. exchange of messages between cooperating systems.  Setting this feature
  5441. tells Pine to try to negotiate unencoded 8bit transmission during the
  5442. sending process.  Should the negotiation fail, Pine will fall back to its
  5443. ordinary encoding rules. 
  5444.  
  5445. Note, this feature relies on your system's mail transport agent or
  5446. configured \"smtp-server\" having the negotiation mechanism introduced in
  5447. \"Extended SMTP\" (ESMTP) and the specific extension called \"8BITMIME\". 
  5448.  
  5449. ESMTP allows for graceful migration to upgraded mail transfer agents, but
  5450. it is possible that this feature might cause problems for some servers. 
  5451.  
  5452. <End of help on this topic>
  5453. ====== h_config_8bit_nntp =====
  5454.         FEATURE: enable-8bit-nntp-posting
  5455.  
  5456. This feature affects Pine's behavior when posting news.  
  5457.  
  5458. The Internet standard for exchanging USENET news messages (RFC-1036)
  5459. specifies that USENET messages should conform to Internet mail standards
  5460. and contain only 7bit characters, but much of the news transport software
  5461. in use today is capable of successfully sending messages containing 8bit
  5462. characters.  Hence, many people believe that it is appropriate to send 8bit
  5463. news messages without any MIME encoding.
  5464.  
  5465. Moreover, there is no Internet standard for explicitly negotiating 8bit
  5466. transfer, as there is for Internet email.  Therefore, Pine provides the
  5467. option of posting unencoded 8bit news messages, though not as the default.
  5468. Setting this feature will turn OFF Pine's MIME encoding of newsgroup
  5469. postings that contain 8bit characters. 
  5470.  
  5471. Note, articles may cross a path or pass through news transport software
  5472. that is unsafe or even hostile to 8bit characters.  At best this will only
  5473. cause the posting to become garbled.  The safest way to transmit 8bit
  5474. characters is to leave Pine's MIME encoding turned on, but recipients
  5475. who lack MIME-aware tools are often annoyed when they receive MIME-encoded 
  5476. messages.
  5477.  
  5478. <End of help on this topic>
  5479. ====== h_config_tab_new_only =====
  5480.         FEATURE: tab-visits-next-new-message-only
  5481.  
  5482. This feature affects Pine's behavior when using the TAB key to move from
  5483. one message to the next.  Pine's usual behavior is to select the next
  5484. unread message or message flagged as \"Important\".
  5485.  
  5486. Setting this feature causes Pine to skip the messages flagged as important,
  5487. and select unread messages exclusively.  Tab behavior when there are no
  5488. new messages left to select remains unchanged.
  5489.  
  5490. <End of help on this topic>
  5491. ====== h_config_quell_dead_letter =====
  5492.         FEATURE: quell-dead-letter-on-cancel
  5493.  
  5494. This feature affects Pine's behavior when you cancel a message being
  5495. composed.  Pine's usual behavior is to write the canceled message to
  5496. a file named \"dead.letter\" in your home directory (under UNIX;
  5497. \"DEADLETR\" under WINDOWS/DOS) overwriting any previous message. Under
  5498. some conditions (some routine), this can introduce a noticeable delay.
  5499.  
  5500. Setting this feature will cause Pine NOT to write canceled compositions
  5501. into the file called dead.letter.
  5502.  
  5503. NOTE: Enabling this feature means NO record of canceled messages is
  5504. maintained.
  5505.  
  5506. <End of help on this topic>
  5507. ====== h_config_quell_beeps =====
  5508.         FEATURE: quell-status-message-beeping
  5509.  
  5510. This feature affects Pine's behavior when it displays status message
  5511. (e.g., Error complaints, New mail warnings, etc).  Setting this feature
  5512. will not affect the display of such messages, but will cause those that
  5513. emit a beep to become silent.
  5514.  
  5515. <End of help on this topic>
  5516. ====== h_config_quell_lock_failure_warnings =====
  5517.         FEATURE: quell-lock-failure-warnings
  5518.  
  5519. This feature affects Pine's behavior when it encounters a problem
  5520. acquiring a mail folder lock.  Typically, a secondary file associated
  5521. with the mail folder being opened is created as part of the locking
  5522. process.  On some systems, such file creation has been administratively
  5523. precluded by the system configuration.
  5524.  
  5525. Pine issues a warning when such failures occur which can become bothersome
  5526. if the system is configured to disallow such actions.  Setting this
  5527. feature causes Pine to remain silent when this part of lock creation fails.
  5528.  
  5529. WARNING: systems that have been configured in a way that precludes locking
  5530. introduce some risk of mail folder corruption when more than one program
  5531. attempts to modify the mail folder.  This is most likely to occur to one's
  5532. INBOX or other incoming message folder. 
  5533.  
  5534.  
  5535. <End of help on this topic>
  5536. ====== h_config_cruise_mode =====
  5537.         FEATURE: enable-cruise-mode
  5538.  
  5539. This feature affects Pine's behavior when you hit the \"Space Bar\" at
  5540. the end of a displayed message.  Typically, Pine complains that the end
  5541. of the text has already been reached.  Setting this feature causes such
  5542. keystrokes to be interpreted as if the \"Tab\" key had been hit, thus
  5543. taking you to the next \"interesting\" message, or scanning ahead to the 
  5544. next incoming folder with \"interesting\" messages.
  5545.  
  5546.  
  5547. <End of help on this topic>
  5548. ====== h_config_cruise_mode_delete =====
  5549.         FEATURE: enable-cruise-mode-delete
  5550.  
  5551. This feature modifies the behavior of Pine's \"enable-cruise-mode\"
  5552. feature.  Setting this feature causes pine to implicitly delete read
  5553. messages when it moves on to display the next \"Interesting\" message.
  5554.  
  5555. NOTE: Beware when enabling this feature AND the \"expunge-without-confirm\"
  5556. feature.
  5557.  
  5558. <End of help on this topic>
  5559. ====== h_config_allow_goto =====
  5560.         FEATURE: enable-goto-in-file-browser
  5561.  
  5562. This feature modifies the behavior of Pine's file browser.  Setting this
  5563. feature causes Pine to offer the \"G Goto\" command in the file browser.
  5564.  
  5565. This command allows you to explicitly set the displayed directory.  Pine's
  5566. default behavior requires you to visit each related directory when between
  5567. two distant directories.
  5568.  
  5569. <End of help on this topic>
  5570. ====== h_config_undo =====
  5571. Yes, save changes and exit; No, exit without saving any changes made since
  5572. entering this CONFIGURATION screen; ^C, cancel exit and stay in config screen.
  5573. ====== h_ab_forward =====
  5574. Yes, expand nicknames and qualify local names with your current domain name;
  5575. No, leave nicknames and local names as is;  ^C, cancel.
  5576. ====== h_os_index_whereis =====
  5577. Enter ^V or ^Y to go immediately to the last or first message in the index.
  5578. Or, enter the match string followed by RETURN.
  5579. ====== h_os_index_whereis_agg =====
  5580. Enter ^V or ^Y to go immediately to the last or first message in the index,
  5581. Or, enter the match string followed by RETURN (or ^X to select all matches).
  5582. =========== h_oe_add_full ==================
  5583. Type the full name of the person being added and press the RETURN key.
  5584. Press ^C to cancel addition.
  5585. =========== h_oe_add_nick ==================
  5586. Type a short nickname and press RETURN.  A nickname is a short easy-to-
  5587. remember word, name or initials like \"joe\", or \"wcfields.\"  ^C to cancel.
  5588. ========== h_oe_add_addr ================
  5589. Type the e-mail address and press RETURN.
  5590. Press ^C to cancel addition.
  5591. ========== h_oe_crlst_full ==============
  5592. Type a long name or description for the list that you are creating and
  5593. press RETURN.  Press ^C to cancel creation of list.
  5594. =========== h_oe_crlst_nick =============
  5595. Type a nickname (short, easy-to-remember name or single word) for the list
  5596. you are creating and press RETURN.  Press ^C to cancel.
  5597. ========== h_oe_crlst_addr ==============
  5598. Type an e-mail address, or a nickname already in the address book that you
  5599. want to be part of this list and press RETURN.
  5600. ========== h_oe_adlst_addr =============
  5601. Type an e-mail address or a nickname already in the address book that you
  5602. want to add to this list and press RETURN.
  5603. ========== h_oe_editab_nick ============
  5604. Change the nickname using the arrow keys and delete key.  Press RETURN
  5605. when done.  Press ^C to cancel editing and leave the nickname as it was.
  5606. ========== h_oe_editab_full ============
  5607. Change the full name using the arrow keys and delete key.  Press RETURN
  5608. when done.  Press ^C to cancel editing and leave the full name as it was.
  5609. ========== h_oe_editab_addr ============
  5610. Change the address using the arrow keys and delete key.  Press RETURN
  5611. when done.  Press ^C to cancel editing and leave the address as it was.
  5612. ========== h_oe_editab_fcc ============
  5613. Change the fcc using the arrow keys and delete key.  Press RETURN when
  5614. done.  Press ^C to cancel editing and leave the fcc as it was.
  5615. ========== h_oe_editab_comment ============
  5616. Change the comment field using the arrow keys and delete key.  Press RETURN
  5617. when done.  Press ^C to cancel editing and leave the comment as it was.
  5618. ========== h_ab_export ==========
  5619. Type the name of a file in your home directory to write the addresses into and
  5620. press RETURN.  You may also give an absolute path or use \"~\".  Use ^C to cancel
  5621. ========== h_ab_edit_a_field ==========
  5622. Edit any of the fields of the currently selected entry by typing one of the
  5623. letters at the bottom of the screen.  Press ^C to cancel edit.
  5624. ========== h_oe_editab_al ============
  5625. Change the address using the arrow keys and delete key.  Press RETURN
  5626. when done.  Press ^C to cancel editing and leave the address as it was.
  5627. ========== h_oe_searchab ===============
  5628. Type the word or name you want to search for and press RETURN.  If you press
  5629. RETURN without entering anything the word in [] will be searched for.
  5630. ========== h_oe_save ==========
  5631. Type the name of the folder you want to save the message in and press RETURN.
  5632. Press ^T to get a list of your folders.  Press ^C to cancel saving this mail.
  5633. ========== h_oe_chooseabook ==========
  5634. Choose the address book you want to save the new entry in.
  5635. Use ^N or ^P to change address books.  ^C to cancel.
  5636. ========== h_oe_takeaddr ==========
  5637. Edit the e-mail address using the arrow and delete keys.  Press RETURN
  5638. when done.  Press ^C to cancel adding this entry to the address book.
  5639. ========== h_oe_take_or_replace ==========
  5640. Press R to replace the old entry with this new list.  Press A to add the
  5641. selected addresses to the old existing list.  Press ^C to cancel addition.
  5642. ========== h_oe_takename ==========
  5643. Edit the full name to be correct using the arrow and delete keys.  Press RETURN
  5644. when done.  Press ^C to cancel adding this entry to the address book.
  5645. ========== h_oe_takenick ==========
  5646. Type a nickname (short easy-to-remember name, initials or single word) for this
  5647. entry in the address book and press RETURN.  Press ^C to cancel addition.
  5648. ========== h_oe_jump ==========
  5649. Type the number of the message number you want to jump to and press
  5650. RETURN.  Press ^C if you want to cancel jumping to another message.
  5651. ========== h_oe_broach ==========
  5652. Type the name of the folder you want to open and press RETURN.  Press ^T to
  5653. get a list of all your folders and make a selection.  Press ^C to cancel open.
  5654. ========== h_oe_foldsearch ==========
  5655. Type the word, name or address you want to search for and press RETURN.  If you
  5656. press RETURN without entering anything the word in [] will be searched for.
  5657. ========== h_oe_foldadd ==========
  5658. Type the name of the folder you want to add and press RETURN.  Press ^C to
  5659. cancel adding a new folder.
  5660. ========== h_oe_foldrename ==========
  5661. Change the old name of the folder to the new name using the arrow and
  5662. delete keys and press RETURN.  Press ^C to cancel rename.
  5663. ========== h_oe_login ==========
  5664. Enter your login name for the host you are opening the mailbox on.  Just press
  5665. RETURN to use your login from this host as is, or edit it with delete key.
  5666. ========== h_oe_passwd ==========
  5667. Type your password for the host and login shown as part of the prompt.
  5668. Press ^C to cancel opening folder.
  5669. ========== h_oe_choosep ==========
  5670. Enter the number associated with the printer you want to select.  Press ^C to
  5671. cancel the printer selection.  The current selection is highlighted.
  5672. ========== h_oe_customp ==========
  5673. Type the name of the Unix print command and press RETURN.  Press ^C to
  5674. cancel the printer selection.
  5675. ========== h_oe_searchview ==========
  5676. Type the word or name you want to search for and press RETURN.  If you press
  5677. RETURN without entering anything the word in [] will be searched for.
  5678. ========== h_oe_keylock ==========
  5679. The keyboard is in use and locked by another user.  Only that user can
  5680. unlock this keyboard by typing the password.
  5681. ========== h_oe_export ==========
  5682. Type the name of a file in your home directory to write the message into and
  5683. press RETURN.  You may also give an absolute path or use \"~\".  Use ^C to cancel
  5684. ========== h_wt_expire ==========
  5685. At the beginning of each month Pine offers to rename your current sent-mail
  5686. folder to one named for the month so you have a sent-mail folder for each month
  5687. ========== h_wt_delete_old ==========
  5688. It is the beginning of the month, and we need to conserve disk
  5689. space.  Please delete any sent-mail that you do not need.
  5690. ========== h_select_sort ==========
  5691. Select the order for sorting the index by typing the capitalized letter.
  5692. Arrival is by arrival in your mailbox; Date is by time/day message was sent.
  5693. ========== h_mini_setup ==========
  5694. Select one of the setup tasks by typing the capitalized letter.
  5695. ========== h_sticky_personal_name ==========
  5696. Type in your name as you want it to appear on outgoing email.  This entry
  5697. will be saved into your Pine configuration file.
  5698. ========== h_sticky_inbox ============
  5699. INBOX syntax is usually {{:{}complete.machine.name}INBOX
  5700. This entry will be saved in your Pine configuration file.
  5701. ========== h_sticky_smtp ============
  5702. The name of the computer on your campus which relays your outgoing email
  5703. to the Internet.  This entry will be saved in your Pine configuration file.
  5704. ========== h_sticky_user_id ==========
  5705. The username or login-id part of your email address.  This entry will be
  5706. saved in your Pine configuration file.
  5707. ========== h_sticky_domain ==========
  5708. The domain part of your email address, NOT the name of your PC.  This
  5709. entry will be saved in your Pine configuration file.
  5710. ========== h_bounce =========
  5711. Enter the address or nickname of the intended recipient.  Pine will resend
  5712. the message, which will retain the original author's From: address.
  5713. ========== h_incoming_add_folder_host =========
  5714. Enter RETURN if the folder is on the machine where Pine is running;
  5715. otherwise enter the host name of the mail server, or ^X if same as INBOX.
  5716. ========== h_incoming_add_folder_name =========
  5717. Enter the name of the desired folder. Pine will attempt to create this
  5718. folder on the previously specified mail server.
  5719. ========== h_incoming_add_folder_nickname =========
  5720. Enter an (optional) nickname that will be used in lieu of the actual
  5721. host and folder names in the FOLDER LIST display.
  5722. ========== h_anon_forward ==========
  5723. Enter the address of your intended recipient, or ^C to cancel.
  5724. Example: jsmith@somewhere.edu
  5725. ========== h_news_subscribe ==========
  5726. Enter the name of the news group to which you wish to subscribe,
  5727. or ^C to cancel.  Example: comp.mail.pine
  5728. ========== h_pipe_msg ==========
  5729. Enter the name of the Unix command to which you wish to send this
  5730. message, or ^C to cancel.
  5731. ========== h_pipe_attach ==========
  5732. Enter the name of the Unix command to which you wish to send this
  5733. attachment, or ^C to cancel.
  5734. ========== h_select_by_num ==========
  5735. Enter a list of numbers (or number range(s)), or ^C to cancel.  The messages
  5736. corresponding to the numbers will be selected.  Example: 2-5,7-9,11,19
  5737. ========== h_select_txt_from ==========
  5738. Messages with From: headers containing the entered string will be selected.
  5739. ^C to cancel. ^R enters current msg From: address.  ^T enters To: address.
  5740. ========== h_select_txt_to ==========
  5741. Messages with To: headers containing the entered string will be selected.
  5742. ^C to cancel. ^R enters current msg From: address.  ^T enters To: address.
  5743. ========== h_select_txt_cc ==========
  5744. Messages with From: headers containing the entered string will be selected.
  5745. ^C to cancel. ^R enters current msg From: address.  ^T enters To: address.
  5746. ========== h_select_txt_subj ==========
  5747. Messages with Subject: headers containing the entered string will be selected.
  5748. ^C to cancel.  ^X enters Subject: line of current message.
  5749. ========== h_select_txt_all ==========
  5750. All messages containing the entered string will be selected.  Headers,
  5751. but not encoded attachments, will be compared.  Enter ^C to cancel.
  5752. ========== h_attach_index_whereis ==========
  5753. Enter some text that appears in the Attachment Index entry for the desired
  5754. attachment.  The first attachment containing that text will be highlighted.
  5755. ========== h_kb_lock ==========
  5756. Keystrokes entered here (up to a RETURN) comprise a password that must
  5757. be entered again later in order to unlock the keyboard.
  5758. ========== h_config_whereis ==========
  5759. To move quickly to a particular line, enter a search string or
  5760. ^C to cancel.
  5761. ========== h_config_add ==========
  5762. Enter desired value; use normal editing keys to modify (e.g. ^K, ^D).  Just
  5763. pressing RETURN sets the Empty Value (this turns off any global default).
  5764. ========== h_config_print_opt_choice ==========
  5765. You may edit either the initialization string (characters printed before
  5766. printing starts) or the trailer string.  Choose one or ^C to cancel.
  5767. ========== h_config_print_init ==========
  5768. Enter a C-style string for this.  You may use common backslash escapes like
  5769. \\n for newline, \\ooo for octal character, and \\xhh for hex character.
  5770. ========== h_config_change ==========
  5771. Edit the existing value using arrow keys, ^K to delete entire entry, ^D to
  5772. delete current (highlighted) character, etc.  Enter ^C to cancel change.
  5773. ========== h_config_replace_add ==========
  5774. Replace ignores the current default, Add places the current default in your
  5775. editing buffer as if you had typed it in.
  5776. ========== h_config_insert_after ==========
  5777. Enter a nickname for this print command.  (InsertBefore puts the new item
  5778. before the current line, InsertAfter puts it after the current line.)
  5779. ========== h_config_print_cmd ==========
  5780. Enter command to be executed for the printer.  Use normal editing keys
  5781. to modify, ^C to cancel, carriage return to accept current value.
  5782. ========== h_config_print_del ==========
  5783. Answering Yes will remove this printer completely from your printer list.
  5784. ========== h_config_print_name_cmd ==========
  5785. You may edit the Nickname of this printer, the Command to be executed when
  5786. printing, or change the Options associated with this printer.
  5787. ========== h_custom_print ==========
  5788. Enter a Unix command that accepts its data on standard input.
  5789. Pine will display any information the command sends to standard output.
  5790.